
<!DOCTYPE HTML>
<html lang="" >
    <head>
        <meta charset="UTF-8">
        <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
        <title>2. API概览 · MobX 中文文档</title>
        <meta http-equiv="X-UA-Compatible" content="IE=edge" />
        <meta name="description" content="">
        <meta name="generator" content="GitBook 3.2.2">
        
        
        
    
    <link rel="stylesheet" href="../gitbook/style.css">

    
            
                
                <link rel="stylesheet" href="../gitbook/gitbook-plugin-anchors/plugin.css">
                
            
                
                <link rel="stylesheet" href="../gitbook/gitbook-plugin-highlight/website.css">
                
            
                
                <link rel="stylesheet" href="../gitbook/gitbook-plugin-search/search.css">
                
            
                
                <link rel="stylesheet" href="../gitbook/gitbook-plugin-fontsettings/website.css">
                
            
        

    

    
        
    
        
    
        
    
        
    
        
    
        
    

        
    
    
    
    <meta name="HandheldFriendly" content="true"/>
    <meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
    <meta name="apple-mobile-web-app-capable" content="yes">
    <meta name="apple-mobile-web-app-status-bar-style" content="black">
    <link rel="apple-touch-icon-precomposed" sizes="152x152" href="../gitbook/images/apple-touch-icon-precomposed-152.png">
    <link rel="shortcut icon" href="../gitbook/images/favicon.ico" type="image/x-icon">

    
    
    <link rel="prev" href="../intro/concepts.html" />
    

    <style>
    @media only screen and (max-width: 640px) {
        .book-header .hidden-mobile {
            display: none;
        }
    }
    </style>
    <script>
        window["gitbook-plugin-github-buttons"] = {"buttons":[{"user":"SangKa","repo":"MobX-Docs-CN","type":"star","size":"small","count":true},{"user":"SangKa","repo":"MobX-Docs-CN","type":"fork","size":"small","count":true}]};
    </script>

    </head>
    <body>
        
<div class="book">
    <div class="book-summary">
        
            
<div id="book-search-input" role="search">
    <input type="text" placeholder="Type to search" />
</div>

            
                <nav role="navigation">
                


<ul class="summary">
    
    

    

    
        
        
    
        <li class="chapter " data-level="1.1" data-path="../">
            
                <a href="../">
            
                    
                    1. MobX 介绍
            
                </a>
            

            
            <ul class="articles">
                
    
        <li class="chapter " data-level="1.1.1" data-path="../intro/overview.html">
            
                <a href="../intro/overview.html">
            
                    
                    1.1. MobX 要点
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.1.2" data-path="../intro/concepts.html">
            
                <a href="../intro/concepts.html">
            
                    
                    1.2. 概念与原则
            
                </a>
            

            
        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter active" data-level="1.2" data-path="api.html">
            
                <a href="api.html">
            
                    
                    2. API概览
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.3" >
            
                <span>
            
                    
                    3. observable 相关
            
                </span>
            

            
            <ul class="articles">
                
    
        <li class="chapter " data-level="1.3.1" data-path="observable.html">
            
                <a href="observable.html">
            
                    
                    3.1. observable
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.3.2" data-path="observable-decorator.html">
            
                <a href="observable-decorator.html">
            
                    
                    3.2. @observable
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.3.3" data-path="object.html">
            
                <a href="object.html">
            
                    
                    3.3. objects
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.3.4" data-path="array.html">
            
                <a href="array.html">
            
                    
                    3.4. arrays
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.3.5" data-path="map.html">
            
                <a href="map.html">
            
                    
                    3.5. maps
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.3.6" data-path="boxed.html">
            
                <a href="boxed.html">
            
                    
                    3.6. boxed values
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.3.7" data-path="modifiers.html">
            
                <a href="modifiers.html">
            
                    
                    3.7 decorators
            
                </a>
            

            
        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="1.4" >
            
                <span>
            
                    
                    4. 对 observables 作出响应
            
                </span>
            

            
            <ul class="articles">
                
    
        <li class="chapter " data-level="1.4.1" data-path="computed-decorator.html">
            
                <a href="computed-decorator.html">
            
                    
                    4.1. (@)computed
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.4.2" data-path="autorun.html">
            
                <a href="autorun.html">
            
                    
                    4.2. autorun
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.4.3" data-path="when.html">
            
                <a href="when.html">
            
                    
                    4.3. when
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.4.4" data-path="reaction.html">
            
                <a href="reaction.html">
            
                    
                    4.4. reaction
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.4.5" data-path="observer-component.html">
            
                <a href="observer-component.html">
            
                    
                    4.5. (@)observer
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.4.6" data-path="../best/react.html">
            
                <a href="../best/react.html">
            
                    
                    4.6. 理解 MobX 对何作出响应
            
                </a>
            

            
        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="1.5" >
            
                <span>
            
                    
                    5. 改变 observables
            
                </span>
            

            
            <ul class="articles">
                
    
        <li class="chapter " data-level="1.5.1" data-path="action.html">
            
                <a href="action.html">
            
                    
                    5.1. action
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.5.2" data-path="../best/actions.html">
            
                <a href="../best/actions.html">
            
                    
                    5.2. async actions & flows
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.5.3" data-path="object-api.html">
            
                <a href="object-api.html">
            
                    
                    5.3. Object api
            
                </a>
            

            
        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="1.6" >
            
                <span>
            
                    
                    6. 工具函数
            
                </span>
            

            
            <ul class="articles">
                
    
        <li class="chapter " data-level="1.6.1" data-path="tojson.html">
            
                <a href="tojson.html">
            
                    
                    6.1. toJS
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.6.2" data-path="extend-observable.html">
            
                <a href="extend-observable.html">
            
                    
                    6.2. extendObservable
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.6.3" data-path="extending.html">
            
                <a href="extending.html">
            
                    
                    6.3. createAtom
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.6.4" data-path="observe.html">
            
                <a href="observe.html">
            
                    
                    6.4. intercept & observe
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.6.5" >
            
                <a target="_blank" href="https://github.com/mobxjs/mobx-utils#frompromise">
            
                    
                    6.5. mobxUtils.fromPromise
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.6.6" >
            
                <a target="_blank" href="https://github.com/mobxjs/mobx-utils#fromresource">
            
                    
                    6.6. mobxUtils.fromResource
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.6.7" >
            
                <a target="_blank" href="https://github.com/mobxjs/mobx-utils#tostream">
            
                    
                    6.7. mobxUtils.toStream
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.6.8" >
            
                <a target="_blank" href="https://github.com/mobxjs/mobx-utils#fromstream">
            
                    
                    6.8. mobxUtils.fromStream
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.6.9" >
            
                <a target="_blank" href="https://github.com/mobxjs/mobx-utils#now">
            
                    
                    6.9. mobxUtils.now
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.6.10" data-path="create-transformer.html">
            
                <a href="create-transformer.html">
            
                    
                    6.10. mobxUtils.createTransformer
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.6.11" data-path="expr.html">
            
                <a href="expr.html">
            
                    
                    6.11. mobxUtils.expr
            
                </a>
            

            
        </li>
    
        <li class="chapter active" data-level="1.6.12" data-path="api.html">
            
                <a href="api.html">
            
                    
                    6.12. complete api overview
            
                </a>
            

            
        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="1.7" >
            
                <a target="_blank" href="https://github.com/mobxjs/awesome-mobx#examples">
            
                    
                    7. 博客、 视频及相关项目
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.8" >
            
                <span>
            
                    
                    8. 贴士与技巧
            
                </span>
            

            
            <ul class="articles">
                
    
        <li class="chapter " data-level="1.8.1" data-path="../faq/faq.html">
            
                <a href="../faq/faq.html">
            
                    
                    8.1. 常见问题解答
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.8.2" data-path="../best/pitfalls.html">
            
                <a href="../best/pitfalls.html">
            
                    
                    8.2. 常见陷阱与最佳实践
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.8.3" data-path="../best/decorators.html">
            
                <a href="../best/decorators.html">
            
                    
                    8.3. 如何(不)使用装饰器
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.8.4" data-path="../best/trace.html">
            
                <a href="../best/trace.html">
            
                    
                    8.4. 使用 trace 进行调试
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.8.5" data-path="../best/store.html">
            
                <a href="../best/store.html">
            
                    
                    8.5. 定义数据存储
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.8.6" data-path="../best/react-performance.html">
            
                <a href="../best/react-performance.html">
            
                    
                    8.6. 优化 React 组件
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.8.7" data-path="../best/devtools.html">
            
                <a href="../best/devtools.html">
            
                    
                    8.7. 开发工具
            
                </a>
            

            
        </li>
    
        <li class="chapter " data-level="1.8.8" data-path="spy.html">
            
                <a href="spy.html">
            
                    
                    8.8. spy
            
                </a>
            

            
        </li>
    

            </ul>
            
        </li>
    
        <li class="chapter " data-level="1.9" data-path="../donating.html">
            
                <a href="../donating.html">
            
                    
                    9. 捐赠
            
                </a>
            

            
        </li>
    

    

    <li class="divider"></li>

    <li>
        <a href="https://www.gitbook.com" target="blank" class="gitbook-link">
            Published with GitBook
        </a>
    </li>
</ul>


                </nav>
            
        
    </div>

    <div class="book-body">
        
            <div class="body-inner">
                
                    

<div class="book-header" role="navigation">
    

    <!-- Title -->
    <h1>
        <i class="fa fa-circle-o-notch fa-spin"></i>
        <a href=".." >2. API概览</a>
    </h1>
</div>




                    <div class="page-wrapper" tabindex="-1" role="main">
                        <div class="page-inner">
                            
<div id="book-search-results">
    <div class="search-noresults">
    
                                <section class="normal markdown-section">
                                
                                <h1 id="mobx-api&#x53C2;&#x8003;"><a name="mobx-api&#x53C2;&#x8003;" class="plugin-anchor" href="#mobx-api&#x53C2;&#x8003;"><i class="fa fa-link" aria-hidden="true"></i></a>MobX API&#x53C2;&#x8003;</h1>
<p><strong>&#x9002;&#x7528;&#x4E8E; MobX 4&#x6216;&#x8005;&#x66F4;&#x9AD8;&#x7248;&#x672C;&#x3002;</strong></p>
<ul>
<li>&#x4F7F;&#x7528;&#x7684;&#x662F; MobX 3 &#xFF1F;&#x53C2;&#x8003;&#x672C;<a href="https://github.com/mobxjs/mobx/wiki/Migrating-from-mobx-3-to-mobx-4" target="_blank">&#x8FC1;&#x79FB;&#x6307;&#x5357;</a>&#x6765;&#x8FDB;&#x884C;&#x5347;&#x7EA7;&#x3002;</li>
<li><a href="https://github.com/mobxjs/mobx/blob/54557dc319b04e92e31cb87427bef194ec1c549c/docs/refguide/api.md" target="_blank">MobX 3 &#x6587;&#x6863;</a></li>
<li>&#x5BF9;&#x4E8E; MobX 2&#xFF0C;&#x65E7;&#x6587;&#x6863;&#x4F9D;&#x7136;&#x53EF;&#x4EE5;&#x5728; <a href="https://github.com/mobxjs/mobx/blob/7c9e7c86e0c6ead141bb0539d33143d0e1f576dd/docs/refguide/api.md" target="_blank">github</a> &#x627E;&#x5230;&#x3002;</li>
</ul>
<h1 id="&#x6838;&#x5FC3;api"><a name="&#x6838;&#x5FC3;api" class="plugin-anchor" href="#&#x6838;&#x5FC3;api"><i class="fa fa-link" aria-hidden="true"></i></a>&#x6838;&#x5FC3;API</h1>
<p><strong>&#x8FD9;&#x91CC;&#x90FD;&#x662F; MobX &#x4E2D;&#x6700;&#x91CD;&#x8981;&#x7684; API &#x3002;</strong></p>
<blockquote>
<p>&#x7406;&#x89E3;&#x4E86;<code>observable</code>&#x3001; <code>computed</code>&#x3001; <code>reactions</code> &#x548C; <code>actions</code>&#x7684;&#x8BDD;&#xFF0C;&#x8BF4;&#x660E;&#x5BF9;&#x4E8E; Mobx &#x5DF2;&#x7ECF;&#x8DB3;&#x591F;&#x7CBE;&#x901A;&#x4E86;,&#x5728;&#x4F60;&#x7684;&#x5E94;&#x7528;&#x4E2D;&#x4F7F;&#x7528;&#x5B83;&#x5427;&#xFF01;</p>
<h2 id="&#x521B;&#x5EFA;-observables"><a name="&#x521B;&#x5EFA;-observables" class="plugin-anchor" href="#&#x521B;&#x5EFA;-observables"><i class="fa fa-link" aria-hidden="true"></i></a>&#x521B;&#x5EFA; observables</h2>
</blockquote>
<h3 id="observablevalue"><a name="observablevalue" class="plugin-anchor" href="#observablevalue"><i class="fa fa-link" aria-hidden="true"></i></a><code>observable(value)</code></h3>
<p>&#x7528;&#x6CD5;:</p>
<ul>
<li><code>observable(value)</code></li>
<li><code>@observable classProperty = value</code></li>
</ul>
<p>Observable &#x503C;&#x53EF;&#x4EE5;&#x662F;JS&#x57FA;&#x672C;&#x6570;&#x636E;&#x7C7B;&#x578B;&#x3001;&#x5F15;&#x7528;&#x7C7B;&#x578B;&#x3001;&#x666E;&#x901A;&#x5BF9;&#x8C61;&#x3001;&#x7C7B;&#x5B9E;&#x4F8B;&#x3001;&#x6570;&#x7EC4;&#x548C;&#x6620;&#x5C04;&#x3002;</p>
<p><strong>&#x6CE8;&#x610F;:</strong> <code>observable(value)</code> &#x662F;&#x4E00;&#x4E2A;&#x4FBF;&#x6377;&#x7684; API &#xFF0C;&#x6B64; API &#x53EA;&#x6709;&#x5728;&#x5B83;&#x53EF;&#x4EE5;&#x88AB;&#x5236;&#x4F5C;&#x6210;&#x53EF;&#x89C2;&#x5BDF;&#x7684;&#x6570;&#x636E;&#x7ED3;&#x6784;(&#x6570;&#x7EC4;&#x3001;&#x6620;&#x5C04;&#x6216; observable &#x5BF9;&#x8C61;)&#x65F6;&#x624D;&#x4F1A;&#x6210;&#x529F;&#x3002;&#x5BF9;&#x4E8E;&#x6240;&#x6709;&#x5176;&#x4ED6;&#x503C;&#xFF0C;&#x4E0D;&#x4F1A;&#x6267;&#x884C;&#x8F6C;&#x6362;&#x3002;</p>
<p>&#x5339;&#x914D;&#x7C7B;&#x578B;&#x5E94;&#x7528;&#x4E86;&#x4EE5;&#x4E0B;&#x8F6C;&#x6362;&#x89C4;&#x5219;&#xFF0C;&#x4F46;&#x53EF;&#x4EE5;&#x901A;&#x8FC7;&#x4F7F;&#x7528; <a href="#decorators"><em>&#x88C5;&#x9970;&#x5668;</em></a> &#x8FDB;&#x884C;&#x5FAE;&#x8C03;&#x3002;&#x8BF7;&#x53C2;&#x89C1;&#x4E0B;&#x6587;&#x3002;</p>
<ol>
<li>&#x5982;&#x679C; <strong>value</strong> &#x662F;<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map" target="_blank">ES6 Map</a>&#x7684;&#x5B9E;&#x4F8B;: &#x4F1A;&#x8FD4;&#x56DE;&#x4E00;&#x4E2A;&#x65B0;&#x7684; <a href="map.html">Observable Map</a>&#x3002;&#x5982;&#x679C;&#x4F60;&#x4E0D;&#x53EA;&#x5173;&#x6CE8;&#x67D0;&#x4E2A;&#x7279;&#x5B9A;entry&#x7684;&#x66F4;&#x6539;&#xFF0C;&#x800C;&#x4E14;&#x5BF9;&#x6DFB;&#x52A0;&#x6216;&#x5220;&#x9664;&#x5176;&#x4ED6;entry&#x65F6;&#x4E5F;&#x505A;&#x51FA;&#x53CD;&#x5E94;&#x7684;&#x8BDD;&#xFF0C;&#x90A3;&#x4E48; Observable map &#x4F1A;&#x975E;&#x5E38;&#x6709;&#x7528;&#x3002;</li>
<li>&#x5982;&#x679C; <strong>value</strong> &#x662F;&#x6570;&#x7EC4;&#xFF0C;&#x4F1A;&#x8FD4;&#x56DE;&#x4E00;&#x4E2A; <a href="array.html">Observable Array</a>&#x3002;</li>
<li>&#x5982;&#x679C; <strong>value</strong> &#x662F;&#x6CA1;&#x6709;&#x539F;&#x578B;&#x7684;&#x5BF9;&#x8C61;&#x6216;&#x5B83;&#x7684;&#x539F;&#x578B;&#x662F; <code>Object.prototype</code>&#xFF0C;&#x90A3;&#x4E48;&#x5BF9;&#x8C61;&#x4F1A;&#x88AB;&#x514B;&#x9686;&#x5E76;&#x4E14;&#x6240;&#x6709;&#x7684;&#x5C5E;&#x6027;&#x90FD;&#x4F1A;&#x88AB;&#x8F6C;&#x6362;&#x6210;&#x53EF;&#x89C2;&#x5BDF;&#x7684;&#x3002;&#x53C2;&#x89C1; <a href="object.html">Observable Object</a>&#x3002;</li>
<li>&#x5982;&#x679C; <strong>value</strong> &#x662F;&#x6709;&#x539F;&#x578B;&#x7684;&#x5BF9;&#x8C61;&#xFF0C;JavaSript &#x539F;&#x59CB;&#x6570;&#x636E;&#x7C7B;&#x578B;&#x6216;&#x8005;&#x51FD;&#x6570;&#xFF0C;&#x503C;&#x4E0D;&#x4F1A;&#x53D1;&#x751F;&#x53D8;&#x5316;&#x3002;&#x5982;&#x679C;&#x4F60;&#x9700;&#x8981; <a href="boxed.html">Boxed Observable</a>&#xFF0C;&#x4F60;&#x53EF;&#x4EE5;&#x91C7;&#x7528;&#x4E0B;&#x5217;&#x4EFB;&#x610F;&#x65B9;&#x5F0F;:<ul>
<li>&#x663E;&#x5F0F;&#x5730;&#x8C03;&#x7528; <code>observable.box(value)</code></li>
<li>&#x5728;&#x7C7B;&#x5B9A;&#x4E49;&#x65F6;&#x4F7F;&#x7528; <code>@observable</code></li>
<li>&#x8C03;&#x7528; <a href="#decorate"><code>decorate()</code></a></li>
<li>&#x5728;&#x7C7B;&#x4E2D;&#x4F7F;&#x7528; <code>extendObservable()</code> &#x6765;&#x5F15;&#x5165;&#x5C5E;&#x6027;</li>
</ul>
</li>
</ol>
<p>MobX &#x4E0D;&#x4F1A;&#x81EA;&#x52A8;&#x5E26;&#x6709;&#x539F;&#x578B;&#x7684;&#x5BF9;&#x8C61;&#x8F6C;&#x53D8;&#x6210; observable&#xFF0C;&#x56E0;&#x4E3A;&#x90A3;&#x662F; observable &#x6784;&#x9020;&#x51FD;&#x6570;&#x7684;&#x804C;&#x8D23;&#x3002;&#x5728;&#x6784;&#x9020;&#x51FD;&#x6570;&#x4E2D;&#x4F7F;&#x7528; <code>extendObservable</code> &#x6216;&#x5728;&#x7C7B;&#x5B9A;&#x4E49;&#x662F;&#x4F7F;&#x7528; <code>@observable</code> &#x8FDB;&#x884C;&#x66FF;&#x4EE3;&#x3002;</p>
<p>&#x4E4D;&#x770B;&#x4E4B;&#x4E0B;&#xFF0C;&#x8FD9;&#x4E9B;&#x89C4;&#x5219;&#x53EF;&#x80FD;&#x770B;&#x4E0A;&#x53BB;&#x5F88;&#x590D;&#x6742;&#xFF0C;&#x4F46;&#x5B9E;&#x9645;&#x4E0A;&#x5B9E;&#x8DF5;&#x5F53;&#x4E2D;&#x4F60;&#x4F1A;&#x53D1;&#x73B0;&#x4ED6;&#x4EEC;&#x662F;&#x975E;&#x5E38;&#x76F4;&#x89C2;&#x7684;&#x3002;</p>
<p>&#x4E00;&#x4E9B;&#x5EFA;&#x8BAE;:</p>
<ul>
<li>&#x8981;&#x60F3;&#x4F7F;&#x7528; <code>@observable</code> &#x88C5;&#x9970;&#x5668;&#xFF0C;&#x9996;&#x5148;&#x8981;&#x786E;&#x4FDD; &#x5728;&#x4F60;&#x7684;&#x7F16;&#x8BD1;&#x5668;(babel &#x6216;&#x8005; typescript)&#x4E2D; <a href="http://mobxjs.github.io/mobx/refguide/observable-decorator.html" target="_blank">&#x88C5;&#x9970;&#x5668;&#x662F;&#x542F;&#x7528;&#x7684;</a>&#x3002;</li>
<li>&#x9ED8;&#x8BA4;&#x60C5;&#x51B5;&#x4E0B;&#x5C06;&#x4E00;&#x4E2A;&#x6570;&#x636E;&#x7ED3;&#x6784;&#x8F6C;&#x6362;&#x6210;&#x53EF;&#x89C2;&#x5BDF;&#x7684;&#x662F;<strong>&#x6709;&#x611F;&#x67D3;&#x6027;&#x7684;</strong>&#xFF0C;&#x8FD9;&#x610F;&#x5473;&#x7740; <code>observable</code> &#x88AB;&#x81EA;&#x52A8;&#x5E94;&#x7528;&#x4E8E;&#x6570;&#x636E;&#x7ED3;&#x6784;&#x5305;&#x542B;&#x7684;&#x4EFB;&#x4F55;&#x503C;&#xFF0C;&#x6216;&#x8005;&#x5C06;&#x6765;&#x4F1A;&#x88AB;&#x8BE5;&#x6570;&#x636E;&#x7ED3;&#x6784;&#x5305;&#x542B;&#x7684;&#x503C;&#x3002;&#x8FD9;&#x4E2A;&#x884C;&#x4E3A;&#x53EF;&#x4EE5;&#x901A;&#x8FC7;&#x4F7F;&#x7528; <a href="#decorators"><em>&#x88C5;&#x9970;&#x5668;</em></a> &#x6765;&#x66F4;&#x6539;&#x3002;</li>
<li><em>[MobX 4 &#x53CA;&#x4EE5;&#x4E0B;&#x7248;&#x672C;]</em> &#x8981;&#x521B;&#x5EFA;&#x952E;&#x662F;&#x52A8;&#x6001;&#x7684;&#x5BF9;&#x8C61;&#x65F6;&#x6C38;&#x8FDC;&#x90FD;&#x4F7F;&#x7528; maps&#xFF01;&#x5BF9;&#x8C61;&#x4E0A;&#x53EA;&#x6709;&#x521D;&#x59CB;&#x5316;&#x65F6;&#x4FBF;&#x5B58;&#x5728;&#x7684;&#x5C5E;&#x6027;&#x4F1A;&#x8F6C;&#x6362;&#x6210;&#x53EF;&#x89C2;&#x5BDF;&#x7684;&#xFF0C;&#x5C3D;&#x7BA1;&#x65B0;&#x6DFB;&#x52A0;&#x7684;&#x5C5E;&#x6027;&#x53EF;&#x4EE5;&#x901A;&#x8FC7;&#x4F7F;&#x7528; <code>extendObservable</code> &#x8F6C;&#x6362;&#x6210;&#x53EF;&#x89C2;&#x5BDF;&#x7684;&#x3002;</li>
</ul>
<p><a href="observable.html">&#xAB;<code>observable</code>&#xBB;</a>  &#x2014;  <a href="observable-decorator.html">&#xAB;<code>@observable</code>&#xBB;</a></p>
<h3 id="observable-property---value"><a name="observable-property---value" class="plugin-anchor" href="#observable-property---value"><i class="fa fa-link" aria-hidden="true"></i></a><code>@observable property =  value</code></h3>
<p><code>observable</code> &#x4E5F;&#x53EF;&#x4EE5;&#x7528;&#x4F5C;&#x5C5E;&#x6027;&#x7684;&#x88C5;&#x9970;&#x5668;&#x3002;&#x5B83;&#x9700;&#x8981;<a href="../best/decorators.html">&#x542F;&#x7528;&#x88C5;&#x9970;&#x5668;</a>&#x800C;&#x4E14;&#x5B83;&#x662F; <code>extendObservable(this, { property: value })</code> &#x7684;&#x8BED;&#x6CD5;&#x7CD6;&#x3002;</p>
<p><a href="observable-decorator.html">&#xAB;<code>&#x8BE6;&#x60C5;</code>&#xBB;</a></p>
<h3 id="observableboxvalue-options"><a name="observableboxvalue-options" class="plugin-anchor" href="#observableboxvalue-options"><i class="fa fa-link" aria-hidden="true"></i></a><code>observable.box(value, options?)</code></h3>
<p>&#x521B;&#x5EFA;&#x4E00;&#x4E2A; observable &#x7684;&#x76D2;&#x5B50;&#xFF0C;&#x5B83;&#x7528;&#x6765;&#x5B58;&#x50A8;value&#x7684; observable &#x5F15;&#x7528;&#x3002;&#x4F7F;&#x7528; <code>get()</code> &#x65B9;&#x6CD5;&#x53EF;&#x4EE5;&#x5F97;&#x5230;&#x76D2;&#x5B50;&#x4E2D;&#x7684;&#x5F53;&#x524D;value&#xFF0C;&#x800C;&#x4F7F;&#x7528; <code>set()</code> &#x65B9;&#x6CD5;&#x53EF;&#x4EE5;&#x66F4;&#x65B0;value&#x3002;
&#x8FD9;&#x662F;&#x6240;&#x6709;&#x5176;&#x5B83; observable &#x521B;&#x5EFA;&#x7684;&#x57FA;&#x7840;&#xFF0C;&#x4F46;&#x5B9E;&#x9645;&#x4E2D;&#x4F60;&#x5176;&#x5B9E;&#x5F88;&#x5C11;&#x80FD;&#x4F7F;&#x7528;&#x5230;&#x5B83;&#x3002;</p>
<p>&#x901A;&#x5E38;&#x76D2;&#x5B50;&#x4F1A;&#x81EA;&#x52A8;&#x5730;&#x5C1D;&#x8BD5;&#x628A;&#x4EFB;&#x4F55;&#x8FD8;&#x4E0D;&#x662F; observable &#x7684;&#x65B0;&#x503C;&#x8F6C;&#x6362;&#x6210; observable &#x3002;&#x4F7F;&#x7528; <code>{deep: false}</code> &#x9009;&#x9879;&#x4F1A;&#x7981;&#x7528;&#x8FD9;&#x9879;&#x884C;&#x4E3A;&#x3002;</p>
<p><a href="boxed.html">&#xAB;<code>&#x8BE6;&#x60C5;</code>&#xBB;</a></p>
<h3 id="observableobjectvalue-decorators-options"><a name="observableobjectvalue-decorators-options" class="plugin-anchor" href="#observableobjectvalue-decorators-options"><i class="fa fa-link" aria-hidden="true"></i></a><code>observable.object(value, decorators?, options?)</code></h3>
<p>&#x4E3A;&#x63D0;&#x4F9B;&#x7684;&#x5BF9;&#x8C61;&#x521B;&#x5EFA;&#x4E00;&#x4E2A;&#x514B;&#x9686;&#x5E76;&#x5C06;&#x5176;&#x6240;&#x6709;&#x7684;&#x5C5E;&#x6027;&#x8F6C;&#x6362;&#x6210; observable &#x3002;
&#x9ED8;&#x8BA4;&#x60C5;&#x51B5;&#x4E0B;&#x8FD9;&#x4E9B;&#x5C5E;&#x6027;&#x4E2D;&#x7684;&#x4EFB;&#x4F55;&#x503C;&#x90FD;&#x4F1A;&#x8F6C;&#x6362;&#x6210; observable&#xFF0C;&#x4F46;&#x5F53;&#x4F7F;&#x7528; <code>{deep: false}</code> &#x9009;&#x9879;&#x65F6;&#x53EA;&#x6709;&#x5C5E;&#x6027;&#x4F1A;&#x8F6C;&#x6362;&#x6210; observable &#x5F15;&#x7528;&#xFF0C;&#x800C;&#x503C;&#x4E0D;&#x4F1A;&#x6539;&#x53D8;(&#x8FD9;&#x4E5F;&#x9002;&#x7528;&#x4E8E;&#x5C06;&#x6765;&#x5206;&#x914D;&#x7684;&#x4EFB;&#x4F55;&#x503C;)&#x3002;</p>
<p><code>observable.object()</code> &#x7684;&#x7B2C;&#x4E8C;&#x4E2A;&#x53C2;&#x6570;&#x53EF;&#x4EE5;&#x5F88;&#x597D;&#x5730;&#x8C03;&#x6574; <a href="#decorators">&#x88C5;&#x9970;&#x5668;</a> &#x7684;&#x53EF;&#x89C2;&#x5BDF;&#x6027;&#x3002;</p>
<p><a href="object.html">&#xAB;<code>&#x8BE6;&#x60C5;</code>&#xBB;</a></p>
<h3 id="observablearrayvalue-options"><a name="observablearrayvalue-options" class="plugin-anchor" href="#observablearrayvalue-options"><i class="fa fa-link" aria-hidden="true"></i></a><code>observable.array(value, options?)</code></h3>
<p>&#x57FA;&#x4E8E;&#x63D0;&#x4F9B;&#x7684;&#x503C;&#x6765;&#x521B;&#x5EFA;&#x4E00;&#x4E2A;&#x65B0;&#x7684; observable &#x6570;&#x7EC4;&#x3002;</p>
<p>&#x5982;&#x679C;&#x4E0D;&#x60F3;&#x6570;&#x7EC4;&#x4E2D;&#x7684;&#x503C;&#x8F6C;&#x6362;&#x6210; observable &#x8BF7;&#x4F7F;&#x7528; <code>{deep: false}</code> &#x9009;&#x9879;&#x3002;</p>
<p><a href="array.html">&#xAB;<code>&#x8BE6;&#x60C5;</code>&#xBB;</a></p>
<h3 id="observablemapvalue-options"><a name="observablemapvalue-options" class="plugin-anchor" href="#observablemapvalue-options"><i class="fa fa-link" aria-hidden="true"></i></a><code>observable.map(value, options?)</code></h3>
<p>&#x57FA;&#x4E8E;&#x63D0;&#x4F9B;&#x7684;&#x503C;&#x6765;&#x521B;&#x5EFA;&#x4E00;&#x4E2A;&#x65B0;&#x7684; observable &#x6620;&#x5C04;&#x3002;&#x5982;&#x679C;&#x4E0D;&#x60F3;&#x6620;&#x5C04;&#x4E2D;&#x7684;&#x503C;&#x8F6C;&#x6362;&#x6210; observable &#x8BF7;&#x4F7F;&#x7528; <code>{deep: false}</code> &#x9009;&#x9879;&#x3002;
&#x5F53;&#x60F3;&#x521B;&#x5EFA;&#x52A8;&#x6001;&#x7684;&#x952E;&#x96C6;&#x5408;&#x5E76;&#x4E14;&#x9700;&#x8981;&#x80FD;&#x89C2;&#x5BDF;&#x5230;&#x952E;&#x7684;&#x6DFB;&#x52A0;&#x548C;&#x79FB;&#x9664;&#x65F6;&#xFF0C;&#x8BF7;&#x4F7F;&#x7528; <code>map</code>&#x3002;
&#x56E0;&#x4E3A;&#x5185;&#x90E8;&#x4F7F;&#x7528;&#x4E86;&#x6210;&#x719F;&#x7684; <em>ES6 Map</em> &#xFF0C;&#x4F60;&#x53EF;&#x4EE5;&#x81EA;&#x7531;&#x4F7F;&#x7528;&#x4EFB;&#x4F55;&#x952E;&#x800C;<strong>&#x65E0;&#x9700;&#x5C40;&#x9650;</strong>&#x4E8E;&#x5B57;&#x7B26;&#x4E32;&#x3002;</p>
<p><a href="map.html">&#xAB;<code>&#x8BE6;&#x60C5;</code>&#xBB;</a></p>
<h3 id="extendobservable"><a name="extendobservable" class="plugin-anchor" href="#extendobservable"><i class="fa fa-link" aria-hidden="true"></i></a><code>extendObservable</code></h3>
<p>&#x7528;&#x6CD5;: <code>extendObservable(target, properties, decorators?, options?)</code></p>
<p>&#x5BF9;&#x4E8E; <code>propertyMap</code> &#x4E2D;&#x7684;&#x6BCF;&#x4E2A;&#x952E;&#x503C;&#x5BF9;&#xFF0C;&#x90FD;&#x4F1A;&#x4F5C;&#x4E3A;&#x4E00;&#x4E2A;(&#x65B0;)&#x7684; observable &#x5C5E;&#x6027;&#x5F15;&#x5165;&#x5230; target &#x5BF9;&#x8C61;&#x4E2D;&#x3002;
&#x8FD8;&#x53EF;&#x4EE5;&#x5728;&#x6784;&#x9020;&#x51FD;&#x6570;&#x4E2D;&#x4F7F;&#x7528;&#x6765;&#x5F15;&#x5165; observable &#x5C5E;&#x6027;&#xFF0C;&#x8FD9;&#x6837;&#x5C31;&#x4E0D;&#x9700;&#x8981;&#x7528;&#x88C5;&#x9970;&#x5668;&#x4E86;&#x3002;
&#x5982;&#x679C; <code>propertyMap</code> &#x7684;&#x67D0;&#x4E2A;&#x503C;&#x662F;&#x4E00;&#x4E2A; getter &#x51FD;&#x6570;&#xFF0C;&#x90A3;&#x4E48;&#x4F1A;&#x5F15;&#x5165;&#x4E00;&#x4E2A;<strong>computed</strong>&#x5C5E;&#x6027;&#x3002;</p>
<p>&#x5982;&#x679C;&#x65B0;&#x7684;&#x5C5E;&#x6027;&#x4E0D;&#x5E94;&#x8BE5;&#x5177;&#x5907;&#x611F;&#x67D3;&#x6027;(&#x5373;&#x65B0;&#x5206;&#x914D;&#x7684;&#x503C;&#x4E0D;&#x5E94;&#x8BE5;&#x81EA;&#x52A8;&#x5730;&#x8F6C;&#x6362;&#x6210; observable)&#x7684;&#x8BDD;&#xFF0C;&#x8BF7;&#x4F7F;&#x7528; <code>extendObservable(target, props, decorators?, {deep: false})</code> &#x3002;
&#x6CE8;&#x610F; <code>extendObservable</code> &#x589E;&#x5F3A;&#x4E86;&#x73B0;&#x6709;&#x7684;&#x5BF9;&#x8C61;&#xFF0C;&#x4E0D;&#x50CF; <code>observable.object</code> &#x662F;&#x521B;&#x5EFA;&#x4E00;&#x4E2A;&#x65B0;&#x5BF9;&#x8C61;&#x3002;</p>
<p><a href="extend-observable.html">&#xAB;&#x8BE6;&#x60C5;&#xBB;</a></p>
<h3 id="&#x88C5;&#x9970;&#x5668;decorators"><a name="&#x88C5;&#x9970;&#x5668;decorators" class="plugin-anchor" href="#&#x88C5;&#x9970;&#x5668;decorators"><i class="fa fa-link" aria-hidden="true"></i></a>&#x88C5;&#x9970;&#x5668;(Decorators)</h3>
<p>&#x4F7F;&#x7528;&#x88C5;&#x9970;&#x5668;&#x53EF;&#x4EE5;&#x5F88;&#x597D;&#x5730;&#x8C03;&#x8282;&#x901A;&#x8FC7; <code>observable</code>&#x3001; <code>extendObservable</code> &#x548C; <code>observable.object</code> &#x5B9A;&#x4E49;&#x7684;&#x5C5E;&#x6027;&#x7684;&#x53EF;&#x89C2;&#x5BDF;&#x6027;&#x3002;&#x5B83;&#x4EEC;&#x8FD8;&#x53EF;&#x4EE5;&#x63A7;&#x5236;&#x7279;&#x5B9A;&#x5C5E;&#x6027;&#x7684;&#x81EA;&#x52A8;&#x8F6C;&#x6362;&#x89C4;&#x5219;&#x3002;</p>
<p>&#x53EF;&#x7528;&#x7684;&#x88C5;&#x9970;&#x5668;&#x5217;&#x8868;:</p>
<ul>
<li><strong><code>observable.deep</code></strong>: &#x6240;&#x6709;  observable &#x90FD;&#x4F7F;&#x7528;&#x7684;&#x9ED8;&#x8BA4;&#x7684;&#x88C5;&#x9970;&#x5668;&#x3002;&#x5B83;&#x53EF;&#x4EE5;&#x628A;&#x4EFB;&#x4F55;&#x6307;&#x5B9A;&#x7684;&#x3001;&#x975E;&#x539F;&#x59CB;&#x6570;&#x636E;&#x7C7B;&#x578B;&#x7684;&#x3001;&#x975E; observable &#x7684;&#x503C;&#x8F6C;&#x6362;&#x6210; observable&#x3002;</li>
<li><strong><code>observable.ref</code></strong>: &#x7981;&#x7528;&#x81EA;&#x52A8;&#x7684; observable &#x8F6C;&#x6362;&#xFF0C;&#x53EA;&#x662F;&#x521B;&#x5EFA;&#x4E00;&#x4E2A; observable &#x5F15;&#x7528;&#x3002;</li>
<li><strong><code>observable.shallow</code></strong>: &#x53EA;&#x80FD;&#x4E0E;&#x96C6;&#x5408;&#x7EC4;&#x5408;&#x4F7F;&#x7528;&#x3002; &#x5C06;&#x4EFB;&#x4F55;&#x5206;&#x914D;&#x7684;&#x96C6;&#x5408;&#x8F6C;&#x6362;&#x4E3A;&#x6D45; observable (&#x800C;&#x4E0D;&#x662F;&#x6DF1; observable)&#x7684;&#x96C6;&#x5408;&#x3002; &#x6362;&#x53E5;&#x8BDD;&#x8BF4;, &#x96C6;&#x5408;&#x4E2D;&#x7684;&#x503C;&#x5C06;&#x4E0D;&#x4F1A;&#x81EA;&#x52A8;&#x53D8;&#x4E3A; observable&#x3002;</li>
<li><strong><code>computed</code></strong>: &#x521B;&#x5EFA;&#x4E00;&#x4E2A;&#x884D;&#x751F;&#x5C5E;&#x6027;, &#x53C2;&#x89C1; <a href="computed-decorator.html"><code>computed</code></a></li>
<li><strong><code>action</code></strong>: &#x521B;&#x5EFA;&#x4E00;&#x4E2A;&#x52A8;&#x4F5C;, &#x53C2;&#x89C1; <a href="action.html"><code>action</code></a></li>
<li><strong><code>action.bound</code></strong>: &#x521B;&#x5EFA;&#x6709;&#x8303;&#x56F4;&#x7684;&#x52A8;&#x4F5C;, &#x53C2;&#x89C1; <a href="action.html"><code>action</code></a></li>
</ul>
<p>&#x53EF;&#x4EE5;&#x4F7F;&#x7528; <em>@decorator</em> &#x8BED;&#x6CD5;&#x6765;&#x5E94;&#x7528;&#x8FD9;&#x4E9B;&#x88C5;&#x9970;&#x5668;:</p>
<pre><code class="lang-javascript"><span class="hljs-keyword">import</span> {observable, action} <span class="hljs-keyword">from</span> <span class="hljs-string">&apos;mobx&apos;</span>;

<span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">TaskStore</span> </span>{
    @observable.shallow tasks = []
    @action addTask(task) { <span class="hljs-comment">/* ... */</span> }
}
</code></pre>
<p>&#x6216;&#x8005;&#x901A;&#x8FC7; <code>observable.object</code> / <code>observable.extendObservable</code> &#x6216; <a href="#decorate"><code>decorate()</code></a> &#x4F20;&#x5165;&#x5C5E;&#x6027;&#x88C5;&#x9970;&#x5668;&#x3002;
&#x6CE8;&#x610F;&#xFF0C;&#x88C5;&#x9970;&#x5668;&#x603B;&#x662F;&#x201C;&#x9644;&#x7740;&#x201D;&#x5728;&#x5C5E;&#x6027;&#x4E0A;&#x7684;&#x3002; &#x56E0;&#x6B64;&#xFF0C;&#x5373;&#x4F7F;&#x5206;&#x914D;&#x4E86;&#x65B0;&#x503C;&#xFF0C;&#x5B83;&#x4EEC;&#x4ECD;&#x5C06;&#x4FDD;&#x6301;&#x6709;&#x6548;&#x3002;</p>
<pre><code class="lang-javascript"><span class="hljs-keyword">import</span> {observable, action} <span class="hljs-keyword">from</span> <span class="hljs-string">&apos;mobx&apos;</span>;

<span class="hljs-keyword">const</span> taskStore = observable({
    tasks: [],
    addTask(task) { <span class="hljs-comment">/* ... */</span> }
}, {
    tasks: observable.shallow,
    addTask: action
})
</code></pre>
<p><a href="modifiers.html">&#xAB;&#x8BE6;&#x60C5;&#xBB;</a></p>
<h3 id="decorate"><a name="decorate" class="plugin-anchor" href="#decorate"><i class="fa fa-link" aria-hidden="true"></i></a><code>decorate</code></h3>
<p>&#x7528;&#x6CD5;: <code>decorate(object, decorators)</code></p>
<p>&#x8FD9;&#x662F;&#x5C06;&#x53EF;&#x89C2;&#x5BDF;&#x6027;<a href="(#decorators">&#x88C5;&#x9970;&#x5668;</a>)&#x5E94;&#x7528;&#x4E8E;&#x666E;&#x901A;&#x5BF9;&#x8C61;&#x6216;&#x7C7B;&#x5B9E;&#x4F8B;&#x7684;&#x7B80;&#x4FBF;&#x65B9;&#x6CD5;&#x3002;&#x7B2C;&#x4E8C;&#x4E2A;&#x53C2;&#x6570;&#x662F;&#x4E00;&#x4E2A;&#x5C5E;&#x6027;&#x8BBE;&#x7F6E;&#x4E3A;&#x67D0;&#x4E9B;&#x88C5;&#x9970;&#x5668;&#x7684;&#x5BF9;&#x8C61;&#x3002;</p>
<p>&#x5F53;&#x65E0;&#x6CD5;&#x4F7F;&#x7528; <em>@decorator</em> &#x8BED;&#x6CD5;&#x6216;&#x9700;&#x8981;&#x5BF9;&#x53EF;&#x89C2;&#x5BDF;&#x6027;&#x8FDB;&#x884C;&#x66F4;&#x7EC6;&#x7C92;&#x5EA6;&#x7684;&#x63A7;&#x5236;&#x65F6;&#x4F7F;&#x7528;&#x8FD9;&#x4E2A;&#x65B9;&#x6CD5;&#x3002;</p>
<pre><code class="lang-js"><span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">TodoList</span> </span>{
    todos = {}
    get unfinishedTodoCount() {
        <span class="hljs-keyword">return</span> values(<span class="hljs-keyword">this</span>.todos).filter(todo =&gt; !todo.finished).length
    }
    addTodo() {
        <span class="hljs-keyword">const</span> t = <span class="hljs-keyword">new</span> Todo()
        t.title = <span class="hljs-string">&apos;Test_&apos;</span> + <span class="hljs-built_in">Math</span>.random()
        set(<span class="hljs-keyword">this</span>.todos, t.id, t)
    }
}

decorate(TodoList, {
    todos: observable,
    unfinishedTodoCount: computed,
    addTodo: action.bound
})
</code></pre>
<p>&#x60F3;&#x8981;&#x5728;&#x5355;&#x4E2A;&#x5C5E;&#x6027;&#x4E0A;&#x5E94;&#x7528;&#x591A;&#x4E2A;&#x88C5;&#x9970;&#x5668;&#x7684;&#x8BDD;&#xFF0C;&#x4F60;&#x53EF;&#x4EE5;&#x4F20;&#x5165;&#x4E00;&#x4E2A;&#x88C5;&#x9970;&#x5668;&#x6570;&#x7EC4;&#x3002;&#x591A;&#x4E2A;&#x88C5;&#x9970;&#x5668;&#x5E94;&#x7528;&#x7684;&#x987A;&#x5E8F;&#x662F;&#x4ECE;&#x4ECE;&#x53F3;&#x81F3;&#x5DE6;&#x3002;</p>
<pre><code class="lang-javascript"><span class="hljs-keyword">import</span> { decorate, observable } <span class="hljs-keyword">from</span> <span class="hljs-string">&apos;mobx&apos;</span>
<span class="hljs-keyword">import</span> { serializable, primitive } <span class="hljs-keyword">from</span> <span class="hljs-string">&apos;serializr&apos;</span>
<span class="hljs-keyword">import</span> persist <span class="hljs-keyword">from</span> <span class="hljs-string">&apos;mobx-persist&apos;</span>

<span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">Todo</span> </span>{
    id = <span class="hljs-built_in">Math</span>.random();
    title = <span class="hljs-string">&apos;&apos;</span>;
    finished = <span class="hljs-literal">false</span>;
}

decorate(Todo, {
    title: [serializable(primitive), persist(<span class="hljs-string">&apos;object&apos;</span>), observable],
    finished: [serializable(primitive), observable]
})
</code></pre>
<p>&#x6CE8;&#x610F;: &#x5E76;&#x975E;&#x6240;&#x6709;&#x7684;&#x88C5;&#x9970;&#x5668;&#x90FD;&#x53EF;&#x4EE5;&#x5728;&#x4E00;&#x8D77;&#x7EC4;&#x5408;&#xFF0C;&#x6B64;&#x529F;&#x80FD;&#x53EA;&#x4F1A;&#x5C3D;&#x529B;&#x800C;&#x4E3A;&#x3002;&#x4E00;&#x4E9B;&#x88C5;&#x9970;&#x5668;&#x4F1A;&#x76F4;&#x63A5;&#x5F71;&#x54CD;&#x5B9E;&#x4F8B;&#xFF0C;&#x5E76;&#x4E14;&#x53EF;&#x4EE5;&#x201C;&#x9690;&#x85CF;&#x201D;&#x5176;&#x4ED6;&#x90A3;&#x4E9B;&#x53EA;&#x66F4;&#x6539;&#x539F;&#x578B;&#x7684;&#x88C5;&#x9970;&#x5668;&#x7684;&#x6548;&#x679C;&#x3002;</p>
<h2 id="computed-values&#x8BA1;&#x7B97;&#x503C;"><a name="computed-values&#x8BA1;&#x7B97;&#x503C;" class="plugin-anchor" href="#computed-values&#x8BA1;&#x7B97;&#x503C;"><i class="fa fa-link" aria-hidden="true"></i></a>Computed values(&#x8BA1;&#x7B97;&#x503C;)</h2>
<p>&#x7528;&#x6CD5;:</p>
<ul>
<li><code>computed(() =&gt; expression)</code></li>
<li><code>computed(() =&gt; expression, (newValue) =&gt; void)</code></li>
<li><code>computed(() =&gt; expression, options)</code></li>
<li><code>@computed({equals: compareFn}) get classProperty() { return expression; }</code></li>
<li><code>@computed get classProperty() { return expression; }</code></li>
</ul>
<p>&#x521B;&#x5EFA;&#x8BA1;&#x7B97;&#x503C;&#xFF0C;<code>expression</code> &#x4E0D;&#x5E94;&#x8BE5;&#x6709;&#x4EFB;&#x4F55;&#x526F;&#x4F5C;&#x7528;&#x800C;&#x53EA;&#x662F;&#x8FD4;&#x56DE;&#x4E00;&#x4E2A;&#x503C;&#x3002;
&#x5982;&#x679C;&#x4EFB;&#x4F55; <code>expression</code> &#x4E2D;&#x4F7F;&#x7528;&#x7684; observable &#x53D1;&#x751F;&#x6539;&#x53D8;&#xFF0C;&#x5B83;&#x90FD;&#x4F1A;&#x81EA;&#x52A8;&#x5730;&#x91CD;&#x65B0;&#x8BA1;&#x7B97;&#xFF0C;&#x4F46;&#x524D;&#x63D0;&#x662F;&#x8BA1;&#x7B97;&#x503C;&#x88AB;&#x67D0;&#x4E9B; <strong>reaction</strong> &#x4F7F;&#x7528;&#x4E86;&#x3002;</p>
<p>&#x8FD8;&#x6709;&#x5404;&#x79CD;&#x9009;&#x9879;&#x53EF;&#x4EE5;&#x63A7;&#x5236; <code>computed</code> &#x7684;&#x884C;&#x4E3A;&#x3002;&#x5305;&#x62EC;:</p>
<ul>
<li><strong><code>equals: (value, value) =&gt; boolean</code></strong> &#x7528;&#x6765;&#x91CD;&#x8F7D;&#x9ED8;&#x8BA4;&#x68C0;&#x6D4B;&#x89C4;&#x5219;&#x7684;&#x6BD4;&#x8F83;&#x51FD;&#x6570;&#x3002; &#x5185;&#x7F6E;&#x6BD4;&#x8F83;&#x5668;&#x6709;: <code>comparer.identity</code>, <code>comparer.default</code>, <code>comparer.structural</code></li>
<li><strong><code>requiresReaction: boolean</code></strong> &#x5728;&#x91CD;&#x65B0;&#x8BA1;&#x7B97;&#x884D;&#x751F;&#x5C5E;&#x6027;&#x4E4B;&#x524D;&#xFF0C;&#x7B49;&#x5F85;&#x8FFD;&#x8E2A;&#x7684; observables &#x503C;&#x53D1;&#x751F;&#x53D8;&#x5316;</li>
<li><strong><code>get: () =&gt; value)</code></strong> &#x91CD;&#x8F7D;&#x8BA1;&#x7B97;&#x5C5E;&#x6027;&#x7684; getter</li>
<li><strong><code>set: (value) =&gt; void</code></strong> &#x91CD;&#x8F7D;&#x8BA1;&#x7B97;&#x5C5E;&#x6027;&#x7684; setter</li>
<li><strong><code>keepAlive: boolean</code></strong> &#x8BBE;&#x7F6E;&#x4E3A; true &#x4EE5;&#x81EA;&#x52A8;&#x4FDD;&#x6301;&#x8BA1;&#x7B97;&#x503C;&#x6D3B;&#x52A8;&#xFF0C;&#x800C;&#x4E0D;&#x662F;&#x5728;&#x6CA1;&#x6709;&#x89C2;&#x5BDF;&#x8005;&#x65F6;&#x6682;&#x505C;&#x3002;</li>
</ul>
<p><a href="computed-decorator.html">&#xAB;&#x8BE6;&#x60C5;&#xBB;</a></p>
<h2 id="actions&#x52A8;&#x4F5C;"><a name="actions&#x52A8;&#x4F5C;" class="plugin-anchor" href="#actions&#x52A8;&#x4F5C;"><i class="fa fa-link" aria-hidden="true"></i></a>Actions(&#x52A8;&#x4F5C;)</h2>
<p>&#x4EFB;&#x4F55;&#x5E94;&#x7528;&#x90FD;&#x6709;&#x52A8;&#x4F5C;&#x3002;&#x52A8;&#x4F5C;&#x662F;&#x4EFB;&#x4F55;&#x7528;&#x6765;&#x4FEE;&#x6539;&#x72B6;&#x6001;&#x7684;&#x4E1C;&#x897F;&#x3002;</p>
<p>&#x4F7F;&#x7528;MobX&#x4F60;&#x53EF;&#x4EE5;&#x5728;&#x4EE3;&#x7801;&#x4E2D;&#x663E;&#x5F0F;&#x5730;&#x6807;&#x8BB0;&#x51FA;&#x52A8;&#x4F5C;&#x6240;&#x5728;&#x7684;&#x4F4D;&#x7F6E;&#x3002;
&#x52A8;&#x4F5C;&#x53EF;&#x4EE5;&#x6709;&#x52A9;&#x4E8E;&#x66F4;&#x597D;&#x7684;&#x7EC4;&#x7EC7;&#x4EE3;&#x7801;&#x3002;
&#x5EFA;&#x8BAE;&#x5728;&#x4EFB;&#x4F55;&#x66F4;&#x6539; observable &#x6216;&#x8005;&#x6709;&#x526F;&#x4F5C;&#x7528;&#x7684;&#x51FD;&#x6570;&#x4E0A;&#x4F7F;&#x7528;&#x52A8;&#x4F5C;&#x3002;
&#x7ED3;&#x5408;&#x5F00;&#x53D1;&#x8005;&#x5DE5;&#x5177;&#x7684;&#x8BDD;&#xFF0C;&#x52A8;&#x4F5C;&#x8FD8;&#x80FD;&#x63D0;&#x4F9B;&#x975E;&#x5E38;&#x6709;&#x7528;&#x7684;&#x8C03;&#x8BD5;&#x4FE1;&#x606F;&#x3002;
&#x6CE8;&#x610F;: &#x5F53;&#x542F;&#x7528;<strong>&#x4E25;&#x683C;&#x6A21;&#x5F0F;</strong>&#x65F6;&#xFF0C;&#x9700;&#x8981;&#x5F3A;&#x5236;&#x4F7F;&#x7528; <code>action</code>&#xFF0C;&#x53C2;&#x89C1; <code>enforceActions</code>&#x3002;</p>
<p><a href="action.html">&#xAB;&#x8BE6;&#x60C5;&#xBB;</a></p>
<p>&#x7528;&#x6CD5;:</p>
<ul>
<li><code>action(fn)</code></li>
<li><code>action(name, fn)</code></li>
<li><code>@action classMethod</code></li>
<li><code>@action(name) classMethod</code></li>
<li><code>@action boundClassMethod = (args) =&gt; { body }</code></li>
<li><code>@action.bound boundClassMethod(args) { body }</code></li>
</ul>
<p>&#x5BF9;&#x4E8E;&#x4E00;&#x6B21;&#x6027;&#x52A8;&#x4F5C;&#xFF0C;&#x53EF;&#x4EE5;&#x4F7F;&#x7528; <code>runInAction(name?, fn)</code> , &#x5B83;&#x662F; <code>action(name, fn)()</code> &#x7684;&#x8BED;&#x6CD5;&#x7CD6;.</p>
<h3 id="flow"><a name="flow" class="plugin-anchor" href="#flow"><i class="fa fa-link" aria-hidden="true"></i></a>Flow</h3>
<p>&#x7528;&#x6CD5;: <code>flow(function* (args) { })</code></p>
<p><code>flow()</code> &#x63A5;&#x6536; generator &#x51FD;&#x6570;&#x4F5C;&#x4E3A;&#x5B83;&#x552F;&#x4E00;&#x7684;&#x8F93;&#x5165;</p>
<p>&#x5F53;&#x5904;&#x7406;<strong>&#x5F02;&#x6B65;&#x52A8;&#x4F5C;</strong>&#x65F6;&#xFF0C;&#x56DE;&#x8C03;&#x4E2D;&#x6267;&#x884C;&#x7684;&#x4EE3;&#x7801;&#x4E0D;&#x4F1A;&#x88AB; <code>action</code> &#x5305;&#x88C5;&#x3002;&#x8FD9;&#x610F;&#x5473;&#x7740;&#x4F60;&#x4FEE;&#x6539;&#x7684; observable state &#x65E0;&#x6CD5;&#x901A;&#x8FC7; <a href="#configure"><code>enforceActions</code></a> &#x68C0;&#x67E5;&#x3002;&#x4FDD;&#x7559;&#x52A8;&#x4F5C;&#x8BED;&#x4E49;&#x7684;&#x7B80;&#x5355;&#x65B9;&#x6CD5;&#x662F;&#x4F7F;&#x7528; flow &#x6765;&#x5305;&#x88C5;&#x5F02;&#x6B65;&#x51FD;&#x6570;&#x3002;&#x8FD9;&#x5C06;&#x786E;&#x4FDD;&#x6240;&#x6709;&#x56DE;&#x8C03;&#x90FD;&#x4F1A;&#x88AB; <code>action()</code> &#x5305;&#x88C5;&#x3002;</p>
<p>&#x6CE8;&#x610F;&#xFF0C;&#x5F02;&#x6B65;&#x51FD;&#x6570;&#x5FC5;&#x987B;&#x662F; <em>generator</em> &#xFF0C;&#x800C;&#x4E14;&#x5728;&#x5185;&#x90E8;&#x53EA;&#x80FD; <em>yield</em> promises &#x3002;<code>flow</code> &#x4F1A;&#x8FD4;&#x56DE;&#x4E00;&#x4E2A; promise &#xFF0C;&#x9700;&#x8981;&#x7684;&#x8BDD;&#x53EF;&#x4EE5;&#x4F7F;&#x7528; <code>cancel()</code> &#x8FDB;&#x884C;&#x64A4;&#x9500;&#x3002;</p>
<pre><code class="lang-js"><span class="hljs-keyword">import</span> { configure } <span class="hljs-keyword">from</span> <span class="hljs-string">&apos;mobx&apos;</span>;

<span class="hljs-comment">// &#x4E0D;&#x5141;&#x8BB8;&#x5728;&#x52A8;&#x4F5C;&#x5916;&#x90E8;&#x4FEE;&#x6539;&#x72B6;&#x6001;</span>
configure({ enforceActions: <span class="hljs-literal">true</span> });

<span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">Store</span> </span>{
    @observable githubProjects = [];
    @observable state = <span class="hljs-string">&quot;pending&quot;</span>; <span class="hljs-comment">// &quot;pending&quot; / &quot;done&quot; / &quot;error&quot;</span>


    fetchProjects = flow(<span class="hljs-function"><span class="hljs-keyword">function</span>* <span class="hljs-title">fetchProjects</span>(<span class="hljs-params"></span>) </span>{ <span class="hljs-comment">// &lt;- &#x6CE8;&#x610F;*&#x53F7;&#xFF0C;&#x8FD9;&#x662F;&#x751F;&#x6210;&#x5668;&#x51FD;&#x6570;&#xFF01;</span>
        <span class="hljs-keyword">this</span>.githubProjects = [];
        <span class="hljs-keyword">this</span>.state = <span class="hljs-string">&quot;pending&quot;</span>;
        <span class="hljs-keyword">try</span> {
            <span class="hljs-keyword">const</span> projects = <span class="hljs-keyword">yield</span> fetchGithubProjectsSomehow(); <span class="hljs-comment">// &#x7528; yield &#x4EE3;&#x66FF; await</span>
            <span class="hljs-keyword">const</span> filteredProjects = somePreprocessing(projects);

            <span class="hljs-comment">// &#x5F02;&#x6B65;&#x4EE3;&#x7801;&#x81EA;&#x52A8;&#x4F1A;&#x88AB; `action` &#x5305;&#x88C5;</span>
            <span class="hljs-keyword">this</span>.state = <span class="hljs-string">&quot;done&quot;</span>;
            <span class="hljs-keyword">this</span>.githubProjects = filteredProjects;
        } <span class="hljs-keyword">catch</span> (error) {
            <span class="hljs-keyword">this</span>.state = <span class="hljs-string">&quot;error&quot;</span>;
        }
    })
}
</code></pre>
<p><em>&#x63D0;&#x793A;: &#x63A8;&#x8350;&#x4E3A; generator &#x51FD;&#x6570;&#x8D77;&#x4E2A;&#x540D;&#x79F0;&#xFF0C;&#x6B64;&#x540D;&#x79F0;&#x5C06;&#x51FA;&#x73B0;&#x5728;&#x5F00;&#x53D1;&#x5DE5;&#x5177;&#x4E2D;</em></p>
<p><strong>Flows &#x53EF;&#x4EE5;&#x64A4;&#x9500;</strong></p>
<p>Flows &#x662F;&#x53EF;&#x4EE5;&#x53D6;&#x6D88;&#x7684;&#xFF0C;&#x8FD9;&#x610F;&#x5473;&#x7740;&#x8C03;&#x7528;&#x8FD4;&#x56DE;&#x7684; promise &#x7684; <code>cancel()</code> &#x65B9;&#x6CD5;&#x3002;&#x8FD9;&#x4F1A;&#x7ACB;&#x5373;&#x505C;&#x6B62; generator &#xFF0C;&#x4F46;&#x662F; <code>finally</code> &#x5B50;&#x53E5;&#x4ECD;&#x4F1A;&#x88AB;&#x5904;&#x7406;&#x3002;
&#x8FD4;&#x56DE;&#x7684; promise &#x672C;&#x8EAB;&#x4F1A;&#x4F7F;&#x7528; <code>FLOW_CANCELLED</code> &#x8FDB;&#x884C; reject &#x3002;</p>
<p><strong>Flows &#x652F;&#x6301;&#x5F02;&#x6B65;&#x8FED;&#x4EE3;&#x5668;</strong></p>
<p>Flows &#x652F;&#x6301;&#x5F02;&#x6B65;&#x8FED;&#x4EE3;&#x5668;&#xFF0C;&#x8FD9;&#x610F;&#x5473;&#x7740;&#x53EF;&#x4EE5;&#x4F7F;&#x7528;&#x5F02;&#x6B65; generators :</p>
<pre><code class="lang-javascript"><span class="hljs-keyword">async</span> <span class="hljs-function"><span class="hljs-keyword">function</span>* <span class="hljs-title">someNumbers</span>(<span class="hljs-params"></span>) </span>{
    <span class="hljs-keyword">yield</span> <span class="hljs-built_in">Promise</span>.resolve(<span class="hljs-number">1</span>)
    <span class="hljs-keyword">yield</span> <span class="hljs-built_in">Promise</span>.resolve(<span class="hljs-number">2</span>)
    <span class="hljs-keyword">yield</span> <span class="hljs-built_in">Promise</span>.resolve(<span class="hljs-number">3</span>)
}

<span class="hljs-keyword">const</span> count = mobx.flow(<span class="hljs-keyword">async</span> <span class="hljs-function"><span class="hljs-keyword">function</span>*(<span class="hljs-params"></span>) </span>{
    <span class="hljs-comment">// &#x4F7F;&#x7528; await &#x6765;&#x5FAA;&#x73AF;&#x5F02;&#x6B65;&#x8FED;&#x4EE3;&#x5668;</span>
    <span class="hljs-keyword">for</span> <span class="hljs-keyword">await</span> (<span class="hljs-keyword">const</span> number <span class="hljs-keyword">of</span> someNumbers()) {
        total += number
    }
    <span class="hljs-keyword">return</span> total
})

<span class="hljs-keyword">const</span> res = <span class="hljs-keyword">await</span> count() <span class="hljs-comment">// 6</span>
</code></pre>
<h2 id="reactions&#x53CD;&#x5E94;--derivations&#x884D;&#x751F;"><a name="reactions&#x53CD;&#x5E94;--derivations&#x884D;&#x751F;" class="plugin-anchor" href="#reactions&#x53CD;&#x5E94;--derivations&#x884D;&#x751F;"><i class="fa fa-link" aria-hidden="true"></i></a>Reactions(&#x53CD;&#x5E94;) &amp; Derivations(&#x884D;&#x751F;)</h2>
<p><strong>&#x8BA1;&#x7B97;&#x503C;</strong> &#x662F;&#x81EA;&#x52A8;&#x54CD;&#x5E94;&#x72B6;&#x6001;&#x53D8;&#x5316;&#x7684;<strong>&#x503C;</strong>&#x3002;
<strong>&#x53CD;&#x5E94;</strong> &#x662F;&#x81EA;&#x52A8;&#x54CD;&#x5E94;&#x72B6;&#x6001;&#x53D8;&#x5316;&#x7684;<strong>&#x526F;&#x4F5C;&#x7528;</strong>&#x3002;
&#x53CD;&#x5E94;&#x53EF;&#x4EE5;&#x786E;&#x4FDD;&#x5F53;&#x76F8;&#x5173;&#x72B6;&#x6001;&#x53D1;&#x751F;&#x53D8;&#x5316;&#x65F6;&#x6307;&#x5B9A;&#x7684;&#x526F;&#x4F5C;&#x7528;(&#x4E3B;&#x8981;&#x662F; I/O)&#x53EF;&#x4EE5;&#x81EA;&#x52A8;&#x5730;&#x6267;&#x884C;&#xFF0C;&#x6BD4;&#x5982;&#x6253;&#x5370;&#x65E5;&#x5FD7;&#x3001;&#x7F51;&#x7EDC;&#x8BF7;&#x6C42;&#x3001;&#x7B49;&#x7B49;&#x3002;
&#x4F7F;&#x7528;&#x53CD;&#x5E94;&#x6700;&#x5E38;&#x89C1;&#x7684;&#x573A;&#x666F;&#x662F; React &#x7EC4;&#x4EF6;&#x7684; <code>observer</code> &#x88C5;&#x9970;&#x5668;(&#x53C2;&#x89C1;&#x4E0B;&#x6587;)&#x3002;</p>
<h3 id="observer"><a name="observer" class="plugin-anchor" href="#observer"><i class="fa fa-link" aria-hidden="true"></i></a><code>observer</code></h3>
<p>&#x53EF;&#x4EE5;&#x7528;&#x4F5C;&#x5305;&#x88F9; React &#x7EC4;&#x4EF6;&#x7684;&#x9AD8;&#x9636;&#x7EC4;&#x4EF6;&#x3002;
&#x5728;&#x7EC4;&#x4EF6;&#x7684; <code>render</code> &#x51FD;&#x6570;&#x4E2D;&#x7684;&#x4EFB;&#x4F55;&#x5DF2;&#x4F7F;&#x7528;&#x7684; observable &#x53D1;&#x751F;&#x53D8;&#x5316;&#x65F6;&#xFF0C;&#x7EC4;&#x4EF6;&#x90FD;&#x4F1A;&#x81EA;&#x52A8;&#x91CD;&#x65B0;&#x6E32;&#x67D3;&#x3002;
&#x6CE8;&#x610F; <code>observer</code> &#x662F;&#x7531; <code>&quot;mobx-react&quot;</code> &#x5305;&#x63D0;&#x4F9B;&#x7684;&#xFF0C;&#x800C;&#x4E0D;&#x662F; <code>mobx</code> &#x672C;&#x8EAB;&#x3002;</p>
<p><a href="observer-component.html">&#xAB;&#x8BE6;&#x60C5;&#xBB;</a></p>
<p>&#x7528;&#x6CD5;:</p>
<ul>
<li><code>observer(React.createClass({ ... }))</code></li>
<li><code>observer((props, context) =&gt; ReactElement)</code></li>
<li><code>observer(class MyComponent extends React.Component { ... })</code></li>
<li><code>@observer class MyComponent extends React.Component { ... }</code></li>
</ul>
<h3 id="autorun"><a name="autorun" class="plugin-anchor" href="#autorun"><i class="fa fa-link" aria-hidden="true"></i></a><code>autorun</code></h3>
<p>&#x7528;&#x6CD5;&#xFF1A;<code>autorun(() =&gt; { sideEffect }, options)</code> &#x3002;<code>autorun</code> &#x8D1F;&#x8D23;&#x8FD0;&#x884C;&#x6240;&#x63D0;&#x4F9B;&#x7684; <code>sideEffect</code> &#x5E76;&#x8FFD;&#x8E2A;&#x5728;<code>sideEffect</code>&#x8FD0;&#x884C;&#x671F;&#x95F4;&#x8BBF;&#x95EE;&#x8FC7;&#x7684; <code>observable</code> &#x7684;&#x72B6;&#x6001;&#x3002;
&#x5C06;&#x6765;&#x5982;&#x679C;&#x6709;&#x5176;&#x4E2D;&#x4E00;&#x4E2A;&#x5DF2;&#x4F7F;&#x7528;&#x7684; observable &#x53D1;&#x751F;&#x53D8;&#x5316;&#xFF0C;&#x540C;&#x6837;&#x7684;<code>sideEffect</code>&#x4F1A;&#x518D;&#x8FD0;&#x884C;&#x4E00;&#x904D;&#x3002;
<code>autorun</code> &#x8FD4;&#x56DE;&#x4E00;&#x4E2A;&#x6E05;&#x7406;&#x51FD;&#x6570;&#x7528;&#x6765;&#x53D6;&#x6D88;&#x526F;&#x4F5C;&#x7528;&#x3002;</p>
<p><a href="autorun.html">&#xAB;&#x8BE6;&#x60C5;&#xBB;</a></p>
<p><strong>&#x9009;&#x9879;</strong></p>
<ul>
<li><strong><code>name?: string</code></strong>: &#x7528;&#x4E8E;&#x8BC6;&#x522B;&#x548C;&#x8C03;&#x8BD5;&#x7684;&#x540D;&#x79F0;</li>
<li><strong><code>delay?: number</code></strong>: &#x4F7F;&#x526F;&#x4F5C;&#x7528;&#x5EF6;&#x8FDF;&#x548C;&#x9632;&#x6296;&#x7684;&#x65F6;&#x95F4;&#x3002;&#x9ED8;&#x8BA4;&#x4E3A; <code>0</code> </li>
<li><strong><code>onError?: (error) =&gt; void</code></strong>: &#x5982;&#x679C; autorun &#x51FD;&#x6570;&#x629B;&#x51FA;&#x5F02;&#x5E38;&#xFF0C;&#x5219;&#x89E6;&#x53D1;&#x9519;&#x8BEF;&#x5904;&#x7406;&#x51FD;&#x6570;</li>
<li><strong><code>scheduler?: (callback) =&gt; void</code></strong>: &#x8BBE;&#x7F6E;&#x81EA;&#x5B9A;&#x4E49;&#x8C03;&#x5EA6;&#x5668;&#x4EE5;&#x51B3;&#x5B9A;&#x5982;&#x4F55;&#x8C03;&#x5EA6; autorun &#x51FD;&#x6570;&#x7684;&#x91CD;&#x65B0;&#x8FD0;&#x884C;</li>
</ul>
<h3 id="when"><a name="when" class="plugin-anchor" href="#when"><i class="fa fa-link" aria-hidden="true"></i></a><code>when</code></h3>
<p>&#x7528;&#x6CD5;: <code>when(() =&gt; condition, () =&gt; { sideEffect }, options)</code> &#x3002;
<code>condition</code> &#x8868;&#x8FBE;&#x5F0F;&#x4F1A;&#x81EA;&#x52A8;&#x54CD;&#x5E94;&#x4EFB;&#x4F55;&#x5B83;&#x6240;&#x4F7F;&#x7528;&#x7684; observable&#x3002;
&#x4E00;&#x65E6;&#x8868;&#x8FBE;&#x5F0F;&#x8FD4;&#x56DE;&#x7684;&#x662F;&#x771F;&#x503C;&#xFF0C;&#x526F;&#x4F5C;&#x7528;&#x51FD;&#x6570;&#x4FBF;&#x4F1A;&#x7ACB;&#x5373;&#x8C03;&#x7528;&#xFF0C;&#x4F46;&#x53EA;&#x4F1A;&#x8C03;&#x7528;&#x4E00;&#x6B21;&#x3002;</p>
<p><strong>&#x6CE8;&#x610F;:</strong> <em>&#x526F;&#x4F5C;&#x7528;&#x51FD;&#x6570;</em> (&#x7B2C;&#x4E8C;&#x4E2A;&#x53C2;&#x6570;) &#x5176;&#x5B9E;&#x662F;&#x53EF;&#x9009;&#x7684;&#x3002;&#x5982;&#x679C;&#x4E0D;&#x63D0;&#x4F9B;&#x526F;&#x4F5C;&#x7528;&#x51FD;&#x6570;&#x7684;&#x8BDD;&#xFF0C;&#x5C06;&#x8FD4;&#x56DE;&#x4E00;&#x4E2A;&#x53EF;&#x53D6;&#x6D88;&#x7684; promise (&#x5373;&#x5177;&#x6709; <code>cancle()</code> &#x65B9;&#x6CD5;&#x7684; promise)</p>
<p><code>when</code> &#x8FD4;&#x56DE;&#x6E05;&#x7406;&#x5668;&#x4EE5;&#x5C3D;&#x65E9;&#x5730;&#x53D6;&#x6D88;&#x64CD;&#x4F5C;&#x3002;</p>
<p>&#x5982;&#x679C;&#x6CA1;&#x6709;&#x7ED9; <code>when</code> &#x4F20;&#x9012;&#x526F;&#x4F5C;&#x7528;&#x51FD;&#x6570;&#x7684;&#x8BDD;&#xFF0C;&#x5B83;&#x5C06;&#x8FD4;&#x56DE;&#x4E00;&#x4E2A;&#x53EF;&#x4EE5;&#x7B49;&#x5F85;&#x6761;&#x4EF6;&#x7ED3;&#x675F;&#x7684; promise &#x3002;</p>
<p><a href="when.html">&#xAB;&#x8BE6;&#x60C5;&#xBB;</a>.</p>
<p><strong>options</strong></p>
<ul>
<li><strong><code>name?: string</code></strong>: &#x7528;&#x4E8E;&#x8BC6;&#x522B;&#x548C;&#x8C03;&#x8BD5;&#x7684;&#x540D;&#x79F0;</li>
<li><strong><code>onError?: (error) =&gt; void</code></strong>: &#x5982;&#x679C; <em>&#x65AD;&#x8A00;&#x51FD;&#x6570;</em> &#x6216; <em>&#x526F;&#x4F5C;&#x7528;&#x51FD;&#x6570;</em> &#x51FD;&#x6570;&#x629B;&#x51FA;&#x5F02;&#x5E38;&#xFF0C;&#x5219;&#x89E6;&#x53D1;&#x9519;&#x8BEF;&#x5904;&#x7406;&#x51FD;&#x6570;</li>
<li><strong><code>timeout: number</code></strong> &#x4EE5;&#x6BEB;&#x79D2;&#x4E3A;&#x5355;&#x4F4D;&#x7684;&#x5EF6;&#x8FDF;&#xFF0C;&#x4E4B;&#x540E;&#x5C06;&#x89E6;&#x53D1; <code>onError</code> &#x5904;&#x7406;&#x51FD;&#x6570;&#xFF0C;&#x4EE5;&#x901A;&#x77E5;&#x5728;&#x6307;&#x5B9A;&#x65F6;&#x95F4;&#x5185;&#x672A;&#x6EE1;&#x8DB3;&#x6761;&#x4EF6;</li>
</ul>
<h3 id="reaction"><a name="reaction" class="plugin-anchor" href="#reaction"><i class="fa fa-link" aria-hidden="true"></i></a><code>reaction</code></h3>
<p>&#x7528;&#x6CD5;: <code>reaction(() =&gt; data, data =&gt; { sideEffect }, options)</code>.
<code>reaction</code> &#x662F; <code>autorun</code> &#x7684;&#x53D8;&#x79CD;&#xFF0C;&#x5728;&#x5982;&#x4F55;&#x8FFD;&#x8E2A; observable &#x65B9;&#x9762;&#x7ED9;&#x4E88;&#x4E86;&#x66F4;&#x7EC6;&#x7C92;&#x5EA6;&#x7684;&#x63A7;&#x5236;&#x3002;
&#x5B83;&#x63A5;&#x6536;&#x4E24;&#x4E2A;&#x51FD;&#x6570;&#xFF0C;&#x7B2C;&#x4E00;&#x4E2A;&#x662F;&#x8FFD;&#x8E2A;&#x5E76;&#x8FD4;&#x56DE;&#x6570;&#x636E;&#xFF0C;&#x8BE5;&#x6570;&#x636E;&#x7528;&#x4F5C;&#x7B2C;&#x4E8C;&#x4E2A;&#x51FD;&#x6570;&#xFF0C;&#x4E5F;&#x5C31;&#x662F;&#x526F;&#x4F5C;&#x7528;&#x7684;&#x8F93;&#x5165;&#x3002;
&#x4E0E; &apos;autorun&apos; &#x4E0D;&#x540C;&#x7684;&#x662F;&#x526F;&#x4F5C;&#x7528;&#x8D77;&#x521D;&#x4E0D;&#x4F1A;&#x8FD0;&#x884C;&#xFF0C;&#x5E76;&#x4E14;&#x5728;&#x6267;&#x884C;&#x526F;&#x4F5C;&#x7528;&#x65F6;&#x8BBF;&#x95EE;&#x7684;&#x4EFB;&#x4F55; observable &#x90FD;&#x4E0D;&#x4F1A;&#x88AB;&#x8FFD;&#x8E2A;&#x3002;
&#x548C; <code>autorunAsync</code> &#x4E00;&#x6837;&#xFF0C;&#x526F;&#x4F5C;&#x7528;&#x662F;&#x53EF;&#x4EE5;&#x8FDB;&#x884C;&#x51FD;&#x6570;&#x53BB;&#x6296;&#x7684;&#x3002;</p>
<p><a href="reaction.html">&#xAB;&#x8BE6;&#x60C5;&#xBB;</a></p>
<p><strong>options</strong></p>
<ul>
<li><strong><code>fireImmediately?: boolean</code></strong>: &#x5728;&#x89E6;&#x53D1; <em>&#x526F;&#x4F5C;&#x7528;&#x51FD;&#x6570;</em> &#x4E4B;&#x524D;&#x7B49;&#x5F85;&#x53D8;&#x5316;&#x3002;&#x9ED8;&#x8BA4;&#x4E3A; <code>false</code></li>
<li><strong><code>delay?: number</code></strong>: &#x4F7F;&#x526F;&#x4F5C;&#x7528;&#x5EF6;&#x8FDF;&#x548C;&#x9632;&#x6296;&#x7684;&#x65F6;&#x95F4;&#x3002;&#x9ED8;&#x8BA4;&#x4E3A; <code>0</code> </li>
<li><strong><code>equals</code></strong>. &#x81EA;&#x5B9A;&#x4E49;&#x76F8;&#x7B49;&#x51FD;&#x6570;&#x6765;&#x786E;&#x5B9A; expr &#x51FD;&#x6570;&#x662F;&#x5426;&#x4E0E;&#x4E4B;&#x524D;&#x7684;&#x7ED3;&#x679C;&#x4E0D;&#x540C;&#xFF0C;&#x518D;&#x51B3;&#x5B9A;&#x662F;&#x5426;&#x89E6;&#x53D1;&#x526F;&#x4F5C;&#x7528;&#x3002;&#x63A5;&#x6536;&#x4E0E; <code>computed</code> &#x7684; equals &#x9009;&#x9879;&#x76F8;&#x540C;&#x7684;&#x9009;&#x9879;</li>
<li>&#x8FD8;&#x63A5;&#x6536; <a href="#autorun"><code>autorun</code></a> &#x7684;&#x6240;&#x6709;&#x9009;&#x9879;</li>
</ul>
<h3 id="onreactionerror"><a name="onreactionerror" class="plugin-anchor" href="#onreactionerror"><i class="fa fa-link" aria-hidden="true"></i></a><code>onReactionError</code></h3>
<p>&#x7528;&#x6CD5;: <code>onReactionError(handler: (error: any, derivation) =&gt; void)</code></p>
<p>&#x6B64;&#x65B9;&#x6CD5;&#x9644;&#x52A0;&#x4E00;&#x4E2A;&#x5168;&#x5C40;&#x9519;&#x8BEF;&#x76D1;&#x542C;&#x5668;&#xFF0C;&#x5BF9;&#x4E8E;&#x4ECE; <em>reaction</em> &#x629B;&#x51FA;&#x7684;&#x6BCF;&#x4E2A;&#x9519;&#x8BEF;&#x90FD;&#x4F1A;&#x8C03;&#x7528;&#x8BE5;&#x9519;&#x8BEF;&#x76D1;&#x542C;&#x5668;&#x3002;
&#x5B83;&#x53EF;&#x4EE5;&#x7528;&#x6765;&#x76D1;&#x63A7;&#x6216;&#x8005;&#x6D4B;&#x8BD5;&#x3002;</p>
<hr>
<h1 id="&#x5B9E;&#x7528;&#x5DE5;&#x5177;"><a name="&#x5B9E;&#x7528;&#x5DE5;&#x5177;" class="plugin-anchor" href="#&#x5B9E;&#x7528;&#x5DE5;&#x5177;"><i class="fa fa-link" aria-hidden="true"></i></a>&#x5B9E;&#x7528;&#x5DE5;&#x5177;</h1>
<p><em>&#x6709;&#x4E00;&#x4E9B;&#x5DE5;&#x5177;&#x51FD;&#x6570;&#x53EF;&#x4EE5;&#x4F7F;&#x5F97; observable &#x6216;&#x8005;  &#x8BA1;&#x7B97;&#x503C;&#x7528;&#x8D77;&#x6765;&#x66F4;&#x65B9;&#x4FBF;&#x3002;
&#x66F4;&#x591A;&#x5B9E;&#x7528;&#x5DE5;&#x5177;&#x53EF;&#x4EE5;&#x5728; <a href="https://github.com/mobxjs/mobx-utils" target="_blank">mobx-utils</a> &#x5305;&#x4E2D;&#x627E;&#x5230;&#x3002;</em></p>
<h3 id="provider-mobx-react-&#x5305;"><a name="provider-mobx-react-&#x5305;" class="plugin-anchor" href="#provider-mobx-react-&#x5305;"><i class="fa fa-link" aria-hidden="true"></i></a><code>Provider</code> (<code>mobx-react</code> &#x5305;)</h3>
<p>&#x53EF;&#x4EE5;&#x7528;&#x6765;&#x4F7F;&#x7528; React &#x7684;<code>context</code>&#x673A;&#x5236;&#x6765;&#x4F20;&#x9012; store &#x7ED9;&#x5B50;&#x7EC4;&#x4EF6;&#x3002;&#x53C2;&#x89C1;<a href="https://github.com/mobxjs/mobx-react#provider-experimental" target="_blank"><code>mobx-react</code> &#x6587;&#x6863;</a>&#x3002;</p>
<h3 id="inject-mobx-react-&#x5305;"><a name="inject-mobx-react-&#x5305;" class="plugin-anchor" href="#inject-mobx-react-&#x5305;"><i class="fa fa-link" aria-hidden="true"></i></a><code>inject</code> (<code>mobx-react</code> &#x5305;)</h3>
<p> &#x76F8;&#x5F53;&#x4E8E;<code>Provider</code> &#x7684;&#x9AD8;&#x9636;&#x7EC4;&#x4EF6;&#x3002;&#x53EF;&#x4EE5;&#x7528;&#x6765;&#x4ECE; React &#x7684;<code>context</code>&#x4E2D;&#x6311;&#x9009; store &#x4F5C;&#x4E3A; prop &#x4F20;&#x9012;&#x7ED9;&#x76EE;&#x6807;&#x7EC4;&#x4EF6;&#x3002;&#x7528;&#x6CD5;:</p>
<ul>
<li><code>inject(&quot;store1&quot;, &quot;store2&quot;)(observer(MyComponent))</code></li>
<li><code>@inject(&quot;store1&quot;, &quot;store2&quot;) @observer MyComponent</code></li>
<li><code>@inject((stores, props, context) =&gt; props) @observer MyComponent</code></li>
<li><code>@observer([&quot;store1&quot;, &quot;store2&quot;]) MyComponent</code> is a shorthand for the the <code>@inject() @observer</code> combo.</li>
</ul>
<h3 id="tojs"><a name="tojs" class="plugin-anchor" href="#tojs"><i class="fa fa-link" aria-hidden="true"></i></a><code>toJS</code></h3>
<p>&#x7528;&#x6CD5;: <code>toJS(observableDataStructure, options?)</code> &#x3002;&#x628A; observable &#x6570;&#x636E;&#x7ED3;&#x6784;&#x8F6C;&#x6362;&#x6210;&#x666E;&#x901A;&#x7684; javascript &#x5BF9;&#x8C61;&#x5E76;&#x5FFD;&#x7565;&#x8BA1;&#x7B97;&#x503C;&#x3002; </p>
<p><code>options</code> &#x5305;&#x62EC;:</p>
<ul>
<li><strong><code>detectCycles: boolean</code></strong>: &#x68C0;&#x67E5; observalbe &#x6570;&#x636E;&#x7ED3;&#x6784;&#x4E2D;&#x7684;&#x5FAA;&#x73AF;&#x5F15;&#x7528;&#x3002;&#x9ED8;&#x8BA4;&#x4E3A; <code>true</code> </li>
<li><strong><code>exportMapsAsObjects: boolean</code></strong>: &#x5C06; ES6 Map &#x4F5C;&#x4E3A;&#x666E;&#x901A;&#x5BF9;&#x8C61;&#x5BFC;&#x51FA;&#x3002;&#x9ED8;&#x8BA4;&#x4E3A; <code>true</code></li>
</ul>
<p><a href="tojson.html">&#xAB;&#x8BE6;&#x60C5;&#xBB;</a>.</p>
<h3 id="isobservable-&#x548C;-isobservableprop"><a name="isobservable-&#x548C;-isobservableprop" class="plugin-anchor" href="#isobservable-&#x548C;-isobservableprop"><i class="fa fa-link" aria-hidden="true"></i></a><code>isObservable</code> &#x548C; <code>isObservableProp</code></h3>
<p>&#x7528;&#x6CD5;: <code>isObservable(thing)</code> &#x6216; <code>isObservableProp(thing, property?)</code> &#x3002;&#x5982;&#x679C;&#x7ED9;&#x5B9A;&#x7684; thing&#xFF0C;&#x6216;&#x8005; thing &#x6307;&#x5B9A;&#x7684; <code>property</code> &#x662F; observable &#x7684;&#x8BDD;&#xFF0C;&#x8FD4;&#x56DE; true&#x3002;
&#x9002;&#x7528;&#x4E8E;&#x6240;&#x6709;&#x7684; observable&#x3001;&#x8BA1;&#x7B97;&#x503C;&#x548C; reaction &#x7684;&#x6E05;&#x7406;&#x51FD;&#x6570;&#x3002;</p>
<p><a href="is-observable">&#xAB;&#x8BE6;&#x60C5;&#xBB;</a></p>
<h3 id="isobservableobjectarraymap-&#x548C;-isboxedobservable"><a name="isobservableobjectarraymap-&#x548C;-isboxedobservable" class="plugin-anchor" href="#isobservableobjectarraymap-&#x548C;-isboxedobservable"><i class="fa fa-link" aria-hidden="true"></i></a><code>isObservableObject|Array|Map</code> &#x548C; <code>isBoxedObservable</code></h3>
<p>&#x7528;&#x6CD5;: <code>isObservableObject(thing)</code>, <code>isObservableArray(thing)</code>, <code>isObservableMap(thing)</code>,  <code>isBoxedObservable(thing)</code>&#x3002; &#x5982;&#x679C;&#x7C7B;&#x578B;&#x5339;&#x914D;&#x7684;&#x8BDD;&#x8FD4;&#x56DE;true&#x3002;</p>
<h3 id="isarraylike"><a name="isarraylike" class="plugin-anchor" href="#isarraylike"><i class="fa fa-link" aria-hidden="true"></i></a><code>isArrayLike</code></h3>
<p>&#x7528;&#x6CD5;: <code>isArrayLike(thing)</code>&#x3002;&#x5982;&#x679C;&#x7ED9;&#x5B9A;&#x7684; thing &#x662F; javascript &#x6570;&#x7EC4;&#x6216;&#x8005; observable (MobX&#x7684;)&#x6570;&#x7EC4;&#x7684;&#x8BDD;&#xFF0C;&#x8FD4;&#x56DE; true&#x3002;
&#x8FD9;&#x4E2A;&#x65B9;&#x6CD5;&#x66F4;&#x7B80;&#x4FBF;&#x3002;
&#x6CE8;&#x610F;&#xFF0C;observable &#x6570;&#x7EC4;&#x53EF;&#x4EE5;&#x901A;&#x8FC7; <code>.slice()</code> &#x8F6C;&#x53D8;&#x6210; javascript &#x6570;&#x7EC4;&#x3002;</p>
<h3 id="isaction"><a name="isaction" class="plugin-anchor" href="#isaction"><i class="fa fa-link" aria-hidden="true"></i></a><code>isAction</code></h3>
<p>&#x7528;&#x6CD5;: <code>isAction(func)</code>&#x3002;&#x5982;&#x679C;&#x7ED9;&#x5B9A;&#x51FD;&#x6570;&#x662F;&#x7528; <code>action</code> &#x65B9;&#x6CD5;&#x5305;&#x88F9;&#x7684;&#x6216;&#x8005;&#x662F;&#x7528; <code>@action</code> &#x88C5;&#x9970;&#x7684;&#x8BDD;&#xFF0C;&#x8FD4;&#x56DE; true&#x3002;</p>
<h3 id="iscomputed-&#x6216;-iscomputedprop"><a name="iscomputed-&#x6216;-iscomputedprop" class="plugin-anchor" href="#iscomputed-&#x6216;-iscomputedprop"><i class="fa fa-link" aria-hidden="true"></i></a><code>isComputed</code> &#x6216; <code>isComputedProp</code></h3>
<p>&#x7528;&#x6CD5;: <code>isComputed(thing)</code> &#x6216; <code>isComputedProp(thing, property?)</code> &#x3002;&#x5982;&#x679C;&#x7ED9;&#x5B9A;&#x7684; thing &#x662F;&#x8BA1;&#x7B97;&#x503C;&#x6216;&#x8005; thing &#x6307;&#x5B9A;&#x7684; <code>property</code> &#x662F;&#x8BA1;&#x7B97;&#x503C;&#x7684;&#x8BDD;&#xFF0C;&#x8FD4;&#x56DE; true &#x3002;</p>
<h3 id="intercept"><a name="intercept" class="plugin-anchor" href="#intercept"><i class="fa fa-link" aria-hidden="true"></i></a><code>intercept</code></h3>
<p>&#x7528;&#x6CD5;: <code>intercept(object, property?, interceptor)</code>.
&#x8FD9;&#x4E2A; API &#x53EF;&#x4EE5;&#x5728;&#x5E94;&#x7528; observable &#x7684;API&#x4E4B;&#x524D;&#xFF0C;&#x62E6;&#x622A;&#x66F4;&#x6539;&#x3002;&#x5BF9;&#x4E8E;&#x9A8C;&#x8BC1;&#x3001;&#x6807;&#x51C6;&#x5316;&#x548C;&#x53D6;&#x6D88;&#x7B49;&#x64CD;&#x4F5C;&#x5341;&#x5206;&#x6709;&#x7528;&#x3002;</p>
<p><a href="observe.html">&#xAB;&#x8BE6;&#x60C5;&#xBB;</a></p>
<h3 id="observe"><a name="observe" class="plugin-anchor" href="#observe"><i class="fa fa-link" aria-hidden="true"></i></a><code>observe</code></h3>
<p>&#x7528;&#x6CD5;: <code>observe(object, property?, listener, fireImmediately = false)</code>
&#x8FD9;&#x662F;&#x4E00;&#x4E2A;&#x5E95;&#x5C42;API&#xFF0C;&#x7528;&#x6765;&#x89C2;&#x5BDF;&#x4E00;&#x4E2A;&#x5355;&#x4E2A;&#x7684; observable &#x503C;&#x3002;</p>
<p><a href="observe.html">&#xAB;&#x8BE6;&#x60C5;&#xBB;</a></p>
<h3 id="onbecomeobserved-&#x548C;-onbecomeunobserved"><a name="onbecomeobserved-&#x548C;-onbecomeunobserved" class="plugin-anchor" href="#onbecomeobserved-&#x548C;-onbecomeunobserved"><i class="fa fa-link" aria-hidden="true"></i></a><code>onBecomeObserved</code> &#x548C; <code>onBecomeUnobserved</code></h3>
<p>&#x7528;&#x6CD5;: <code>onBecomeObserved(observable, property?, listener: () =&gt; void): (() =&gt; void)</code> &#x548C;
<code>onBecomeUnobserved(observable, property?, listener: () =&gt; void): (() =&gt; void)</code>
&#x8FD9;&#x4E9B;&#x51FD;&#x6570;&#x90FD;&#x662F;&#x4E0E; MobX &#x7684;&#x89C2;&#x5BDF;&#x4F53;&#x7CFB;&#x6302;&#x94A9;&#x7684;&#xFF0C;&#x5F53; observables <em>&#x5F00;&#x59CB;</em> / <em>&#x505C;&#x6B62;</em> &#x88AB;&#x89C2;&#x5BDF;&#x65F6;&#x4F1A;&#x6536;&#x5230;&#x901A;&#x77E5;&#x3002;&#x5B83;&#x53EF;&#x4EE5;&#x7528;&#x6765;&#x6267;&#x884C;&#x4E00;&#x4E9B;&#x5EF6;&#x8FDF;&#x64CD;&#x4F5C;&#x6216;&#x7F51;&#x7EDC;&#x8D44;&#x6E90;&#x83B7;&#x53D6;&#x3002;</p>
<p>&#x8FD4;&#x56DE;&#x503C;&#x4E3A; <em>&#x6E05;&#x7406;&#x51FD;&#x6570;</em>&#xFF0C;&#x7528;&#x6765;&#x5378;&#x8F7D; <em>&#x76D1;&#x542C;&#x5668;</em> &#x3002;</p>
<pre><code class="lang-javascript">
<span class="hljs-keyword">export</span> <span class="hljs-class"><span class="hljs-keyword">class</span> <span class="hljs-title">City</span> </span>{
    @observable location
    @observable temperature
    interval

    <span class="hljs-keyword">constructor</span>(location) {
        <span class="hljs-keyword">this</span>.location = location
        <span class="hljs-comment">// &#x53EA;&#x6709;&#x5F53; temperature &#x5B9E;&#x9645;&#x4F7F;&#x7528;&#x4E86;&#x624D;&#x5F00;&#x59CB;&#x83B7;&#x53D6;&#x6570;&#x636E;!</span>
        onBecomeObserved(<span class="hljs-keyword">this</span>, <span class="hljs-string">&apos;temperature&apos;</span>, <span class="hljs-keyword">this</span>.resume)
        onBecomeUnobserved(<span class="hljs-keyword">this</span>, <span class="hljs-string">&apos;temperature&apos;</span>, <span class="hljs-keyword">this</span>.suspend)
    }

    resume = () =&gt; {
        log(<span class="hljs-string">`Resuming <span class="hljs-subst">${this.location}</span>`</span>)
        <span class="hljs-keyword">this</span>.interval = setInterval(() =&gt; <span class="hljs-keyword">this</span>.fetchTemperature(), <span class="hljs-number">5000</span>)
    }

    suspend = () =&gt; {
        log(<span class="hljs-string">`Suspending <span class="hljs-subst">${this.location}</span>`</span>)
        <span class="hljs-keyword">this</span>.temperature = <span class="hljs-literal">undefined</span>
        clearInterval(<span class="hljs-keyword">this</span>.interval)
    }

    @flow fetchTemperature = <span class="hljs-function"><span class="hljs-keyword">function</span>*(<span class="hljs-params"></span>) </span>{
        <span class="hljs-comment">// &#x6570;&#x636E;&#x83B7;&#x53D6;&#x903B;&#x8F91;</span>
    }
}
</code></pre>
<h3 id="configure"><a name="configure" class="plugin-anchor" href="#configure"><i class="fa fa-link" aria-hidden="true"></i></a><code>configure</code></h3>
<p>&#x7528;&#x6CD5;: <code>configure(options)</code> &#x3002;
&#x5BF9;&#x6D3B;&#x52A8;&#x7684; MobX &#x5B9E;&#x4F8B;&#x8FDB;&#x884C;&#x5168;&#x5C40;&#x884C;&#x4E3A;&#x8BBE;&#x7F6E;&#x3002;
&#x4F7F;&#x7528;&#x5B83;&#x6765;&#x6539;&#x53D8; MobX &#x7684;&#x6574;&#x4F53;&#x8868;&#x73B0;&#x3002;</p>
<pre><code class="lang-javascript"><span class="hljs-keyword">import</span> { configure } <span class="hljs-keyword">from</span> <span class="hljs-string">&quot;mobx&quot;</span>;

configure({
    <span class="hljs-comment">// ...</span>
});
</code></pre>
<h4 id="arraybuffer-number"><a name="arraybuffer-number" class="plugin-anchor" href="#arraybuffer-number"><i class="fa fa-link" aria-hidden="true"></i></a><code>arrayBuffer: number</code></h4>
<p>&#x5982;&#x679C;&#x6CA1;&#x6709;&#x6700;&#x5927;&#x957F;&#x5EA6;&#x7684;&#x8BDD;&#xFF0C;&#x5219;&#x5C06;&#x53EF;&#x89C2;&#x5BDF;&#x6570;&#x7EC4;&#x7684;&#x9ED8;&#x8BA4;&#x521B;&#x5EFA;&#x957F;&#x5EA6;&#x589E;&#x52A0;&#x81F3; <code>arrayBuffer</code> &#x3002;</p>
<p>&#x53EF;&#x89C2;&#x5BDF;&#x6570;&#x7EC4;&#x4F1A;&#x5728; <code>ObservableArray.prototype</code> &#x4E0A;&#x60F0;&#x6027;&#x5730;&#x521B;&#x5EFA;&#x6570;&#x7EC4;&#x9879;&#x7684; getters &#xFF0C;&#x4ECE;&#x7B2C;&#x4E00;&#x9879;&#x5F00;&#x59CB;&#x3002;
&#x8FD8;&#x4F1A;&#x7EE7;&#x7EED;&#x5728;&#x6570;&#x7EC4;&#x4E2D;&#x521B;&#x5EFA;&#x9879;&#xFF0C;&#x76F4;&#x5230;&#x6570;&#x7EC4;&#x957F;&#x5EA6;&#x4E3A; <code>arrayBuffer</code> (&#x5982;&#x679C;&#x9879;&#x4E0D;&#x5B58;&#x5728;&#x7684;&#x8BDD;) &#x3002;
&#x5982;&#x679C;&#x4F60;&#x6E05;&#x695A;&#x901A;&#x7528;&#x7684;&#x6700;&#x5C0F;&#x6570;&#x7EC4;&#x957F;&#x5EA6;&#xFF0C;&#x5E76;&#x4E14;&#x4E0D;&#x60F3;&#x5728;&#x4E3B;&#x6D41;&#x7A0B;&#x4EE3;&#x7801;&#x4E2D;&#x521B;&#x5EFA;&#x8FD9;&#x4E9B; getters &#x7684;&#x8BDD;&#xFF0C;&#x8BF7;&#x4F7F;&#x7528; <code>arrayBuffer</code> &#x3002;
&#x8FD8;&#x53EF;&#x4EE5;&#x53C2;&#x89C1; <code>observable</code> &#x3002;</p>
<h4 id="computedrequiresreaction-boolean"><a name="computedrequiresreaction-boolean" class="plugin-anchor" href="#computedrequiresreaction-boolean"><i class="fa fa-link" aria-hidden="true"></i></a><code>computedRequiresReaction: boolean</code></h4>
<p>&#x7981;&#x6B62;&#x8BBF;&#x95EE;&#x4EFB;&#x4F55;&#x672A;&#x89C2;&#x5BDF;&#x7684;&#x8BA1;&#x7B97;&#x503C;&#x3002;
&#x5982;&#x679C;&#x60F3;&#x68C0;&#x67E5;&#x662F;&#x5426;&#x5728;&#x6CA1;&#x6709;&#x54CD;&#x5E94;&#x5F0F;&#x4E0A;&#x4E0B;&#x6587;&#x4E2D;&#x7684;&#x4F7F;&#x7528;&#x8BA1;&#x7B97;&#x5C5E;&#x6027;&#x7684;&#x8BDD;&#xFF0C;&#x8BF7;&#x4F7F;&#x7528;&#x5B83;&#x3002;</p>
<pre><code class="lang-javascript">configure({ computedRequiresReaction: <span class="hljs-literal">true</span> });
</code></pre>
<h4 id="disableerrorboundaries-boolean"><a name="disableerrorboundaries-boolean" class="plugin-anchor" href="#disableerrorboundaries-boolean"><i class="fa fa-link" aria-hidden="true"></i></a><code>disableErrorBoundaries: boolean</code></h4>
<p>&#x9ED8;&#x8BA4;&#x60C5;&#x51B5;&#x4E0B;&#xFF0C;MobX &#x4F1A;&#x6355;&#x83B7;&#x5E76;&#x91CD;&#x65B0;&#x629B;&#x51FA;&#x4EE3;&#x7801;&#x4E2D;&#x53D1;&#x751F;&#x7684;&#x5F02;&#x5E38;&#xFF0C;&#x4ECE;&#x800C;&#x786E;&#x4FDD;&#x67D0;&#x4E2A;&#x5F02;&#x5E38;&#x4E2D;&#x7684;&#x53CD;&#x5E94; (reaction) &#x4E0D;&#x4F1A;&#x963B;&#x6B62;&#x5176;&#x4ED6;&#x53EF;&#x80FD;&#x65E0;&#x5173;&#x7684;&#x53CD;&#x5E94;&#x7684;&#x9884;&#x5B9A;&#x6267;&#x884C;&#x3002;&#x8FD9;&#x610F;&#x5473;&#x7740;&#x5F02;&#x5E38;&#x4E0D;&#x4F1A;&#x4F20;&#x64AD;&#x5230;&#x539F;&#x59CB;&#x4EE3;&#x7801;&#x4E2D;&#xFF0C;&#x56E0;&#x6B64;&#x5C06;&#x65E0;&#x6CD5;&#x4F7F;&#x7528; try/catch &#x6765;&#x6355;&#x83B7;&#x5B83;&#x4EEC;&#x3002;</p>
<p>&#x6709;&#x65F6;&#x4F60;&#x53EF;&#x80FD;&#x60F3;&#x8981;&#x6355;&#x83B7;&#x8FD9;&#x4E9B;&#x9519;&#x8BEF;&#xFF0C;&#x4F8B;&#x5982;&#x5728;&#x5355;&#x5143;&#x6D4B;&#x8BD5;&#x53CD;&#x5E94;&#x65F6;&#x3002;&#x6B64;&#x65F6;&#x53EF;&#x4EE5;&#x4F7F;&#x7528; <code>disableErrorBoundaries</code> &#x6765;&#x7981;&#x7528;&#x6B64;&#x884C;&#x4E3A;&#x3002;</p>
<pre><code class="lang-javascript">configure({ disableErrorBoundaries: <span class="hljs-literal">true</span> });
</code></pre>
<p>&#x8BF7;&#x6CE8;&#x610F;&#xFF0C;&#x4F7F;&#x7528;&#x6B64;&#x914D;&#x7F6E;&#x65F6;&#xFF0C;MobX &#x5E76;&#x4E0D;&#x4F1A;&#x56DE;&#x590D;&#x9519;&#x8BEF;&#x3002;&#x51FA;&#x4E8E;&#x8FD9;&#x4E2A;&#x539F;&#x56E0;&#xFF0C;&#x4F60;&#x53EF;&#x80FD;&#x9700;&#x8981;&#x5728;&#x6BCF;&#x4E2A;&#x5F02;&#x5E38;&#x4E4B;&#x540E;&#x4F7F;&#x7528; <code>_resetGlobalState</code> &#x3002;&#x793A;&#x4F8B;&#x5982;&#x4E0B;:</p>
<pre><code class="lang-js">configure({ disableErrorBoundaries: <span class="hljs-literal">true</span> })

test(<span class="hljs-string">&apos;Throw if age is negative&apos;</span>, () =&gt; {
  expect(() =&gt; {
    <span class="hljs-keyword">const</span> age = observable.box(<span class="hljs-number">10</span>)
    autorun(() =&gt; { <span class="hljs-keyword">if</span> (age.get() &lt; <span class="hljs-number">0</span>) <span class="hljs-keyword">throw</span> <span class="hljs-keyword">new</span> <span class="hljs-built_in">Error</span>(<span class="hljs-string">&apos;Age should not be negative&apos;</span>) })
    age.set(<span class="hljs-number">-1</span>)
  }).toThrow()
  _resetGlobalState() <span class="hljs-comment">// &#x6BCF;&#x4E2A;&#x5F02;&#x5E38;&#x8FC7;&#x540E;&#x90FD;&#x9700;&#x8981;</span>
})
</code></pre>
<blockquote>
<p>&#x5728; MobX 4 &#x4E4B;&#x524D;&#xFF0C;<code>_resetGlobalState</code> &#x540D;&#x4E3A; <code>extras.resetGlobalState</code> &#x3002;</p>
</blockquote>
<h4 id="enforceactions"><a name="enforceactions" class="plugin-anchor" href="#enforceactions"><i class="fa fa-link" aria-hidden="true"></i></a><code>enforceActions</code></h4>
<p>&#x4E5F;&#x88AB;&#x79F0;&#x4E3A;&#x201C;&#x4E25;&#x683C;&#x6A21;&#x5F0F;&#x201D;&#x3002;</p>
<p>&#x5728;&#x4E25;&#x683C;&#x6A21;&#x5F0F;&#x4E0B;&#xFF0C;&#x4E0D;&#x5141;&#x8BB8;&#x5728; <a href="action.html"><code>action</code></a> &#x5916;&#x66F4;&#x6539;&#x4EFB;&#x4F55;&#x72B6;&#x6001;&#x3002;
&#x53EF;&#x63A5;&#x6536;&#x7684;&#x503C;:</p>
<ul>
<li><code>&quot;never&quot;</code> (&#x9ED8;&#x8BA4;): &#x53EF;&#x4EE5;&#x5728;&#x4EFB;&#x610F;&#x5730;&#x65B9;&#x4FEE;&#x6539;&#x72B6;&#x6001;</li>
<li><code>&quot;observed&quot;</code>: &#x5728;&#x67D0;&#x5904;&#x89C2;&#x5BDF;&#x5230;&#x7684;&#x6240;&#x6709;&#x72B6;&#x6001;&#x90FD;&#x9700;&#x8981;&#x901A;&#x8FC7;&#x52A8;&#x4F5C;&#x8FDB;&#x884C;&#x66F4;&#x6539;&#x3002;&#x5728;&#x6B63;&#x5F0F;&#x5E94;&#x7528;&#x4E2D;&#x63A8;&#x8350;&#x6B64;&#x4E25;&#x683C;&#x6A21;&#x5F0F;&#x3002;</li>
<li><code>&quot;always&quot;</code>: &#x72B6;&#x6001;&#x59CB;&#x7EC8;&#x9700;&#x8981;&#x901A;&#x8FC7;&#x52A8;&#x4F5C;&#x6765;&#x66F4;&#x65B0;(&#x5B9E;&#x9645;&#x4E0A;&#x8FD8;&#x5305;&#x62EC;&#x521B;&#x5EFA;)&#x3002;</li>
</ul>
<h4 id="isolateglobalstate-boolean"><a name="isolateglobalstate-boolean" class="plugin-anchor" href="#isolateglobalstate-boolean"><i class="fa fa-link" aria-hidden="true"></i></a><code>isolateGlobalState: boolean</code></h4>
<p>&#x5F53;&#x540C;&#x4E00;&#x73AF;&#x5883;&#x4E2D;&#x6709;&#x591A;&#x4E2A; MobX &#x5B9E;&#x4F8B;&#x65F6;&#xFF0C;&#x5C06; MobX &#x7684;&#x5168;&#x5C40;&#x72B6;&#x6001;&#x9694;&#x79BB;&#x3002;
&#x5F53;&#x4F7F;&#x7528; MobX &#x7684;&#x540C;&#x65F6;&#x8FD8;&#x4F7F;&#x7528;&#x4E86;&#x4F7F;&#x7528; MobX &#x7684;&#x5C01;&#x88C5;&#x5E93;&#x65F6;&#xFF0C;&#x8FD9;&#x662F;&#x975E;&#x5E38;&#x6709;&#x7528;&#x7684;&#x3002;
&#x5F53;&#x5728;&#x5E93;&#x4E2D;&#x8C03;&#x7528; <code>configure({isolateGlobalState&#xFF1A;true})</code> &#x65F6;&#xFF0C;&#x5E93;&#x5185;&#x7684;&#x54CD;&#x5E94;&#x6027;&#x5C06;&#x4FDD;&#x6301;&#x72EC;&#x7ACB;&#x3002;</p>
<p>&#x4F7F;&#x7528;&#x6B64;&#x9009;&#x9879;&#xFF0C;&#x5982;&#x679C;&#x591A;&#x4E2A; MobX &#x5B9E;&#x4F8B;&#x6B63;&#x5728;&#x4F7F;&#x7528;&#x7684;&#x8BDD;&#xFF0C;&#x5185;&#x90E8;&#x72B6;&#x6001;&#x662F;&#x4F1A;&#x5171;&#x4EAB;&#x7684;&#x3002;&#x4F18;&#x70B9;&#x5C31;&#x662F;&#x4E24;&#x4E2A;&#x5B9E;&#x4F8B;&#x7684; observables &#x53EF;&#x4EE5;&#x534F;&#x540C;&#x8FD0;&#x884C;&#xFF0C;&#x7F3A;&#x70B9;&#x662F; MobX &#x7684;&#x7248;&#x672C;&#x5FC5;&#x987B;&#x5339;&#x914D;&#x3002;</p>
<pre><code class="lang-javascript">configure({ isolateGlobalState: <span class="hljs-literal">true</span> });
</code></pre>
<h4 id="reactionscheduler-f---void--void"><a name="reactionscheduler-f---void--void" class="plugin-anchor" href="#reactionscheduler-f---void--void"><i class="fa fa-link" aria-hidden="true"></i></a><code>reactionScheduler: (f: () =&gt; void) =&gt; void</code></h4>
<p>&#x8BBE;&#x7F6E;&#x4E00;&#x4E2A;&#x65B0;&#x51FD;&#x6570;&#xFF0C;&#x7528;&#x6765;&#x6267;&#x884C;&#x6240;&#x6709; MobX &#x7684;&#x53CD;&#x5E94; (reactions) &#x3002;
&#x9ED8;&#x8BA4;&#x60C5;&#x51B5;&#x4E0B;&#xFF0C;<code>reactionScheduler</code> &#x53EA;&#x4F1A;&#x8FD0;&#x884C;&#x53CD;&#x5E94; <code>f</code> &#x800C;&#x6CA1;&#x6709;&#x5176;&#x4ED6;&#x4EFB;&#x4F55;&#x884C;&#x4E3A;&#x3002;
&#x8FD9;&#x5BF9;&#x4E8E;&#x57FA;&#x672C;&#x7684;&#x8C03;&#x8BD5;&#x6216;&#x8005;&#x51CF;&#x6162;&#x53CD;&#x5E94;&#x4EE5;&#x4F7F;&#x7528;&#x5E94;&#x7528;&#x7684;&#x66F4;&#x65B0;&#x66F4;&#x52A0;&#x53EF;&#x89C6;&#x5316;&#x6765;&#x8BF4;&#x662F;&#x975E;&#x5E38;&#x6709;&#x7528;&#x7684;&#x3002;</p>
<pre><code class="lang-javascript">configure({
    reactionScheduler: (f): <span class="hljs-keyword">void</span> =&gt; {
        <span class="hljs-built_in">console</span>.log(<span class="hljs-string">&quot;Running an event after a delay:&quot;</span>, f);
        setTimeout(f, <span class="hljs-number">100</span>);
    }
});
</code></pre>
<h2 id="&#x76F4;&#x63A5;&#x64CD;&#x63A7;-observable"><a name="&#x76F4;&#x63A5;&#x64CD;&#x63A7;-observable" class="plugin-anchor" href="#&#x76F4;&#x63A5;&#x64CD;&#x63A7;-observable"><i class="fa fa-link" aria-hidden="true"></i></a>&#x76F4;&#x63A5;&#x64CD;&#x63A7; Observable</h2>
<p>&#x73B0;&#x5728;&#x6709;&#x4E00;&#x4E2A;&#x7EDF;&#x4E00;&#x7684;&#x5DE5;&#x5177; API &#x53EF;&#x4EE5;&#x64CD;&#x63A7; observable &#x6620;&#x5C04;&#x3001;&#x5BF9;&#x8C61;&#x548C;&#x6570;&#x7EC4;&#x3002;&#x8FD9;&#x4E9B; API &#x90FD;&#x662F;&#x54CD;&#x5E94;&#x5F0F;&#x7684;&#xFF0C;&#x8FD9;&#x610F;&#x5473;&#x7740;&#x5982;&#x679C;&#x4F7F;&#x7528; <code>set</code> &#x8FDB;&#x884C;&#x6DFB;&#x52A0;&#xFF0C;&#x4F7F;&#x7528; <code>values</code> &#x6216; <code>keys</code> &#x8FDB;&#x884C;&#x8FED;&#x4EE3;&#xFF0C;&#x5373;&#x4FBF;&#x662F;&#x65B0;&#x5C5E;&#x6027;&#x7684;&#x58F0;&#x660E;&#x90FD;&#x53EF;&#x4EE5;&#x88AB; MobX &#x68C0;&#x6D4B;&#x5230;&#x3002;</p>
<ul>
<li><strong><code>values(thing)</code></strong> &#x5C06;&#x96C6;&#x5408;&#x4E2D;&#x7684;&#x6240;&#x6709;&#x503C;&#x4F5C;&#x4E3A;&#x6570;&#x7EC4;&#x8FD4;&#x56DE;</li>
<li><strong><code>keys(thing)</code></strong> &#x5C06;&#x96C6;&#x5408;&#x4E2D;&#x7684;&#x6240;&#x6709;&#x952E;&#x4F5C;&#x4E3A;&#x6570;&#x7EC4;&#x8FD4;&#x56DE;</li>
<li><strong><code>entries(thing)</code></strong> &#x8FD4;&#x56DE;&#x96C6;&#x5408;&#x4E2D;&#x7684;&#x6240;&#x6709;&#x9879;&#x7684;&#x952E;&#x503C;&#x5BF9;&#x6570;&#x7EC4;</li>
<li><strong><code>set(thing, key, value)</code></strong> &#x6216; <strong><code>set(thing, { key: value })</code></strong> &#x4F7F;&#x7528;&#x63D0;&#x4F9B;&#x7684;&#x952E;&#x503C;&#x5BF9;&#x6765;&#x66F4;&#x65B0;&#x7ED9;&#x5B9A;&#x7684;&#x96C6;&#x5408;</li>
<li><strong><code>remove(thing, key)</code></strong> &#x4ECE;&#x96C6;&#x5408;&#x4E2D;&#x79FB;&#x9664;&#x6307;&#x5B9A;&#x7684;&#x9879;&#x3002;&#x7528;&#x4E8E;&#x6570;&#x7EC4;&#x62FC;&#x63A5;</li>
<li><strong><code>has(thing, key)</code></strong> &#x5982;&#x679C;&#x96C6;&#x5408;&#x4E2D;&#x5B58;&#x5728;&#x6307;&#x5B9A;&#x7684; <em>observable</em> &#x5C5E;&#x6027;&#x5C31;&#x8FD4;&#x56DE; true</li>
</ul>
<h1 id="&#x5F00;&#x53D1;&#x5DE5;&#x5177;"><a name="&#x5F00;&#x53D1;&#x5DE5;&#x5177;" class="plugin-anchor" href="#&#x5F00;&#x53D1;&#x5DE5;&#x5177;"><i class="fa fa-link" aria-hidden="true"></i></a>&#x5F00;&#x53D1;&#x5DE5;&#x5177;</h1>
<p><em>&#x5982;&#x679C;&#x4F60;&#x60F3;&#x5728; MobX &#x7684;&#x4E0A;&#x5C42;&#x6784;&#x5EFA;&#x4E00;&#x4E9B;&#x5F88;&#x9177;&#x7684;&#x5DE5;&#x5177;&#x6216;&#x8005;&#x60F3;&#x68C0;&#x67E5; MobX &#x7684;&#x5185;&#x90E8;&#x72B6;&#x6001;&#x7684;&#x8BDD;&#xFF0C;&#x4E0B;&#x5217;API&#x53EF;&#x80FD;&#x4F1A;&#x6D3E;&#x4E0A;&#x7528;&#x573A;&#x3002;</em></p>
<h3 id="mobx-react-devtools-&#x5305;"><a name="mobx-react-devtools-&#x5305;" class="plugin-anchor" href="#mobx-react-devtools-&#x5305;"><i class="fa fa-link" aria-hidden="true"></i></a><code>&quot;mobx-react-devtools&quot;</code> &#x5305;</h3>
<p>mobx-react-devtools &#x662F;&#x4E2A;&#x529F;&#x80FD;&#x5F3A;&#x5927;&#x7684;&#x5305;&#xFF0C;&#x5B83;&#x5E2E;&#x52A9;&#x4F60;&#x8C03;&#x67E5; React &#x7EC4;&#x4EF6;&#x7684;&#x6027;&#x80FD;&#x548C;&#x4F9D;&#x8D56;&#x3002;
&#x8FD8;&#x6709;&#x57FA;&#x4E8E; <code>spy</code> &#x7684;&#x5F3A;&#x5927;&#x7684;&#x65E5;&#x5FD7;&#x529F;&#x80FD;&#x3002;</p>
<p><a href="../best/devtools.html">&#xAB;&#x8BE6;&#x60C5;&#xBB;</a></p>
<h3 id="trace"><a name="trace" class="plugin-anchor" href="#trace"><i class="fa fa-link" aria-hidden="true"></i></a><code>trace</code></h3>
<p>&#x7528;&#x6CD5;:</p>
<ul>
<li><code>trace(enterDebugger?)</code></li>
<li><code>trace(Reaction object / ComputedValue object / disposer function, enterDebugger?)</code></li>
<li><code>trace(object, computedValuePropertyName, enterDebugger?)</code></li>
</ul>
<p><code>trace</code> &#x662F;&#x4E00;&#x4E2A;&#x53EF;&#x4EE5;&#x5728;&#x8BA1;&#x7B97;&#x503C;&#x6216; reaction &#x4E2D;&#x4F7F;&#x7528;&#x7684;&#x5C0F;&#x5DE5;&#x5177;&#x3002;
&#x5982;&#x679C;&#x542F;&#x7528;&#x4E86;&#x5B83;&#xFF0C;&#x90A3;&#x4E48;&#x5F53;&#x503C;&#x88AB;&#x65E0;&#x6548;&#x65F6;&#xFF0C;&#x5B83;&#x5C06;&#x5F00;&#x59CB;&#x8BB0;&#x5F55;&#xFF0C;&#x4EE5;&#x53CA;&#x4E3A;&#x4EC0;&#x4E48;&#x3002;
&#x5982;&#x679C; <code>enterDebugger</code> &#x8BBE;&#x7F6E;&#x4E3A; true &#xFF0C;&#x5E76;&#x4E14;&#x542F;&#x7528;&#x5F00;&#x53D1;&#x8005;&#x5DE5;&#x5177;&#x7684;&#x8BDD;&#xFF0C;JavaScript &#x5F15;&#x64CE;&#x4F1A;&#x5728;&#x89E6;&#x53D1;&#x65F6;&#x5728;&#x6B64;&#x8FDB;&#x884C;&#x65AD;&#x70B9;&#x8C03;&#x8BD5;&#x3002;</p>
<p><a href="../best/trace.html">&#xAB;trace&#xBB;</a></p>
<h3 id="spy"><a name="spy" class="plugin-anchor" href="#spy"><i class="fa fa-link" aria-hidden="true"></i></a><code>spy</code></h3>
<p>&#x7528;&#x6CD5;: <code>spy(listener)</code> &#x3002;
&#x5B83;&#x7C7B;&#x4F3C;&#x4E8E;&#x5C06;&#x4E00;&#x4E2A; <code>observe</code> &#x76D1;&#x542C;&#x5668;&#x4E00;&#x6B21;&#x6027;&#x9644;&#x52A0;&#x5230;<strong>&#x6240;&#x6709;&#x7684;</strong> observables &#x4E0A;&#xFF0C;&#x800C;&#x4E14;&#x8FD8;&#x8D1F;&#x8D23;&#x6B63;&#x5728;&#x8FD0;&#x884C;&#x7684;&#x52A8;&#x4F5C;&#x548C;&#x8BA1;&#x7B97;&#x7684;&#x901A;&#x77E5;&#x3002;
&#x7528;&#x4E8E; <code>mobx-react-devtools</code> &#x3002;</p>
<p><a href="spy.html">&#xAB;&#x8BE6;&#x60C5;&#xBB;</a></p>
<h3 id="getatom"><a name="getatom" class="plugin-anchor" href="#getatom"><i class="fa fa-link" aria-hidden="true"></i></a><code>getAtom</code></h3>
<p>&#x7528;&#x6CD5;: <code>getAtom(thing, property?)</code> &#x3002;
&#x8FD4;&#x56DE;&#x7ED9;&#x5B9A;&#x7684; observable &#x5BF9;&#x8C61;&#x3001;&#x5C5E;&#x6027;&#x3001;reaction &#x7B49;&#x7684;&#x80CC;&#x540E;&#x4F5C;&#x7528;&#x7684;<code>Atom</code>&#x3002;</p>
<h3 id="getdebugname"><a name="getdebugname" class="plugin-anchor" href="#getdebugname"><i class="fa fa-link" aria-hidden="true"></i></a><code>getDebugName</code></h3>
<p>&#x7528;&#x6CD5;: <code>getDebugName(thing, property?)</code> &#x3002;
&#x8FD4;&#x56DE; observable &#x5BF9;&#x8C61;&#x3001;&#x5C5E;&#x6027;&#x3001;reaction&#x7B49;(&#x751F;&#x6210;&#x7684;)&#x6613;&#x8BFB;&#x7684;&#x8C03;&#x8BD5;&#x540D;&#x79F0;&#x3002;&#x7528;&#x4E8E; <code>mobx-react-devtools</code> &#x7684;&#x793A;&#x4F8B;&#x3002;</p>
<h3 id="getdependencytree"><a name="getdependencytree" class="plugin-anchor" href="#getdependencytree"><i class="fa fa-link" aria-hidden="true"></i></a><code>getDependencyTree</code></h3>
<p>&#x7528;&#x6CD5;: <code>getDependencyTree(thing, property?)</code> &#x3002;
&#x8FD4;&#x56DE;&#x7ED9;&#x5B9A;&#x7684; reaction / &#x8BA1;&#x7B97; &#x5F53;&#x524D;&#x4F9D;&#x8D56;&#x7684;&#x6240;&#x6709; observable &#x7684;&#x6811;&#x578B;&#x7ED3;&#x6784;&#x3002;</p>
<h3 id="getobservertree"><a name="getobservertree" class="plugin-anchor" href="#getobservertree"><i class="fa fa-link" aria-hidden="true"></i></a><code>getObserverTree</code></h3>
<p>&#x7528;&#x6CD5;: <code>getObserverTree(thing, property?)</code> &#x3002;
&#x8FD4;&#x56DE;&#x6B63;&#x5728;&#x89C2;&#x5BDF;&#x7ED9;&#x5B9A;&#x7684; observable &#x7684;&#x6240;&#x6709; reaction / &#x8BA1;&#x7B97;&#x7684;&#x6811;&#x578B;&#x7ED3;&#x6784;&#x3002;</p>
<h3 id="mobx-react-&#x5F00;&#x53D1;&#x94A9;&#x5B50;"><a name="mobx-react-&#x5F00;&#x53D1;&#x94A9;&#x5B50;" class="plugin-anchor" href="#mobx-react-&#x5F00;&#x53D1;&#x94A9;&#x5B50;"><i class="fa fa-link" aria-hidden="true"></i></a><code>&quot;mobx-react&quot;</code> &#x5F00;&#x53D1;&#x94A9;&#x5B50;</h3>
<p><code>mobx-react</code> &#x5305;&#x63D0;&#x4F9B;&#x4E86;&#x4EE5;&#x4E0B;&#x51E0;&#x4E2A;&#x4F9B; <code>mobx-react-devtools</code> &#x4F7F;&#x7528;&#x7684;&#x9644;&#x52A0;API:</p>
<ul>
<li><code>trackComponents()</code>: &#x542F;&#x7528;&#x8FFD;&#x8E2A;&#x529F;&#x80FD;,&#x8FFD;&#x8E2A;&#x4F7F;&#x7528;&#x4E86;<code>observer</code>&#x7684; React &#x7EC4;&#x4EF6;</li>
<li><code>renderReporter.on(callback)</code>: &#x4F7F;&#x7528; <code>observer</code> &#x7684; React &#x7EC4;&#x4EF6;&#x6BCF;&#x6B21;&#x6E32;&#x67D3;&#x90FD;&#x4F1A;&#x8C03;&#x7528;callback&#xFF0C;&#x5E76;&#x9644;&#x5E26;&#x76F8;&#x5173;&#x7684;&#x65F6;&#x95F4;&#x4FE1;&#x606F;&#x7B49;&#x7B49;</li>
<li><code>componentByNodeRegistery</code>: &#x4F7F;&#x7528;ES6 WeakMap &#x5C06; DOMNode &#x6620;&#x5C04;&#x5230;&#x4F7F;&#x7528; <code>observer</code> &#x7684; React &#x7EC4;&#x4EF6;&#x5B9E;&#x4F8B;</li>
</ul>
<h1 id="&#x5185;&#x90E8;&#x51FD;&#x6570;"><a name="&#x5185;&#x90E8;&#x51FD;&#x6570;" class="plugin-anchor" href="#&#x5185;&#x90E8;&#x51FD;&#x6570;"><i class="fa fa-link" aria-hidden="true"></i></a>&#x5185;&#x90E8;&#x51FD;&#x6570;</h1>
<p><em>&#x4EE5;&#x4E0B;&#x65B9;&#x6CD5;&#x90FD;&#x5728; MobX &#x5185;&#x90E8;&#x4F7F;&#x7528;&#xFF0C;&#x5728;&#x6781;&#x5C11;&#x6570;&#x60C5;&#x51B5;&#x4E0B;&#x53EF;&#x80FD;&#x4F1A;&#x6D3E;&#x4E0A;&#x7528;&#x573A;&#x3002; &#x4F46;&#x662F;&#x901A;&#x5E38; MobX &#x63D0;&#x4F9B;&#x4E86;&#x66F4;&#x591A;&#x7684;&#x58F0;&#x660E;&#x6027;&#x66FF;&#x4EE3;&#x65B9;&#x6CD5;&#x6765;&#x89E3;&#x51B3;&#x540C;&#x6837;&#x7684;&#x95EE;&#x9898;&#x3002;&#x5982;&#x679C;&#x4F60;&#x5C1D;&#x8BD5;&#x6269;&#x5C55; MobX &#x7684;&#x8BDD;&#xFF0C;&#x5B83;&#x4EEC;&#x53EF;&#x80FD;&#x4F1A;&#x6D3E;&#x4E0A;&#x7528;&#x573A;&#x3002;</em></p>
<h3 id="transaction"><a name="transaction" class="plugin-anchor" href="#transaction"><i class="fa fa-link" aria-hidden="true"></i></a><code>transaction</code></h3>
<p><em>Transaction &#x662F;&#x5E95;&#x5C42; API , &#x63A8;&#x8350;&#x4F7F;&#x7528; actions &#x6765;&#x4EE3;&#x66FF;</em></p>
<p><code>transaction(worker: () =&gt; void)</code> &#x53EF;&#x4EE5;&#x7528;&#x6765;&#x6279;&#x91CF;&#x66F4;&#x65B0;&#x800C;&#x4E0D;&#x4F1A;&#x901A;&#x77E5;&#x4EFB;&#x4F55;&#x89C2;&#x5BDF;&#x8005;&#xFF0C;&#x76F4;&#x5230;&#x4E8B;&#x52A1;&#x7ED3;&#x675F;&#x3002;
<code>transaction</code> &#x63A5;&#x6536;&#x4E00;&#x4E2A;&#x65E0;&#x53C2;&#x7684; <code>worker</code> &#x51FD;&#x6570;&#x4F5C;&#x4E3A;&#x53C2;&#x6570;&#xFF0C;&#x5E76;&#x8FD0;&#x884C;&#x5B83;&#x3002;
&#x5230;&#x8FD9;&#x4E2A;&#x51FD;&#x6570;&#x5B8C;&#x6210;&#x524D;&#x90FD;&#x4E0D;&#x4F1A;&#x6709;&#x4EFB;&#x4F55;&#x89C2;&#x5BDF;&#x8005;&#x6536;&#x5230;&#x901A;&#x77E5;&#x3002;
<code>transaction</code> &#x8FD4;&#x56DE; <code>worker</code> &#x51FD;&#x6570;&#x8FD4;&#x56DE;&#x7684;&#x4EFB;&#x610F;&#x503C;&#x3002;
&#x6CE8;&#x610F;&#xFF0C;<code>transaction</code> &#x7684;&#x8FD0;&#x884C;&#x5B8C;&#x5168;&#x662F;&#x540C;&#x6B65;&#x7684;&#x3002;
transactions &#x53EF;&#x4EE5;&#x662F;&#x5D4C;&#x5957;&#x7684;&#x3002;&#x53EA;&#x6709;&#x5F53;&#x6700;&#x5916;&#x5C42;&#x7684; <code>transaction</code> &#x5B8C;&#x6210;&#x540E;&#xFF0C;&#x7B49;&#x5F85;&#x4E2D;&#x7684; reactions &#x624D;&#x4F1A;&#x8FD0;&#x884C;&#x3002;</p>
<pre><code class="lang-javascript"><span class="hljs-keyword">import</span> {observable, transaction, autorun} <span class="hljs-keyword">from</span> <span class="hljs-string">&quot;mobx&quot;</span>;

<span class="hljs-keyword">const</span> numbers = observable([]);

autorun(() =&gt; <span class="hljs-built_in">console</span>.log(numbers.length, <span class="hljs-string">&quot;numbers!&quot;</span>));
<span class="hljs-comment">// &#x8F93;&#x51FA;: &apos;0 numbers!&apos;</span>

transaction(() =&gt; {
    transaction(() =&gt; {
        numbers.push(<span class="hljs-number">1</span>);
        numbers.push(<span class="hljs-number">2</span>);
    });
    numbers.push(<span class="hljs-number">3</span>);
});
<span class="hljs-comment">// &#x8F93;&#x51FA;: &apos;3 numbers!&apos;</span>
</code></pre>
<h3 id="untracked"><a name="untracked" class="plugin-anchor" href="#untracked"><i class="fa fa-link" aria-hidden="true"></i></a><code>untracked</code></h3>
<p>untracked &#x5141;&#x8BB8;&#x4F60;&#x5728;&#x6CA1;&#x6709;&#x89C2;&#x5BDF;&#x8005;&#x7684;&#x60C5;&#x51B5;&#x4E0B;&#x8FD0;&#x884C;&#x4E00;&#x6BB5;&#x4EE3;&#x7801;&#x3002;
&#x5C31;&#x50CF; <code>transaction</code> &#xFF0C;<code>untracked</code> &#x7531; <code>(@)action</code> &#x81EA;&#x52A8;&#x5E94;&#x7528;&#xFF0C;&#x6240;&#x4EE5;&#x901A;&#x5E38;&#x4F7F;&#x7528;&#x52A8;&#x4F5C;&#x8981;&#x6BD4;&#x76F4;&#x63A5; <code>untracked</code> &#x6709;&#x610F;&#x4E49;&#x5F97;&#x591A;&#x3002;
&#x793A;&#x4F8B;:</p>
<pre><code class="lang-javascript">
<span class="hljs-keyword">const</span> person = observable({
    firstName: <span class="hljs-string">&quot;Michel&quot;</span>,
    lastName: <span class="hljs-string">&quot;Weststrate&quot;</span>
});

autorun(() =&gt; {
    <span class="hljs-built_in">console</span>.log(
        person.lastName,
        <span class="hljs-string">&quot;,&quot;</span>,
        <span class="hljs-comment">// &#x8FD9;&#x4E2A; untracked &#x4EE3;&#x7801;&#x5757;&#x4F1A;&#x5728;&#x6CA1;&#x6709;&#x5EFA;&#x7ACB;&#x4F9D;&#x8D56;&#x7684;&#x60C5;&#x51B5;&#x4E0B;&#x8FD4;&#x56DE; person &#x7684; firstName</span>
        untracked(() =&gt; person.firstName)
    );
});
<span class="hljs-comment">// &#x8F93;&#x51FA;: Weststrate, Michel</span>

person.firstName = <span class="hljs-string">&quot;G.K.&quot;</span>;
<span class="hljs-comment">// &#x4E0D;&#x8F93;&#x51FA;&#xFF01;</span>

person.lastName = <span class="hljs-string">&quot;Chesterton&quot;</span>;
<span class="hljs-comment">// &#x8F93;&#x51FA;: Chesterton, G.K.</span>
</code></pre>
<h3 id="createatom"><a name="createatom" class="plugin-anchor" href="#createatom"><i class="fa fa-link" aria-hidden="true"></i></a><code>createAtom</code></h3>
<p>&#x5B9E;&#x7528;&#x7A0B;&#x5E8F;&#x7C7B;&#xFF0C;&#x53EF;&#x7528;&#x4E8E;&#x521B;&#x5EFA;&#x4F60;&#x81EA;&#x5DF1;&#x7684; observable &#x6570;&#x636E;&#x7ED3;&#x6784;&#xFF0C;&#x5E76;&#x5C06;&#x5B83;&#x4EEC;&#x8FDE;&#x63A5;&#x5230; MobX&#x3002;
&#x5728;&#x6240;&#x6709; observable &#x6570;&#x636E;&#x7C7B;&#x578B;&#x7684;&#x5185;&#x90E8;&#x4F7F;&#x7528;&#x3002;</p>
<p><a href="extending.html">&#xAB;&#x8BE6;&#x60C5;&#xBB;</a></p>

                                
                                </section>
                            
    </div>
    <div class="search-results">
        <div class="has-results">
            
            <h1 class="search-results-title"><span class='search-results-count'></span> results matching "<span class='search-query'></span>"</h1>
            <ul class="search-results-list"></ul>
            
        </div>
        <div class="no-results">
            
            <h1 class="search-results-title">No results matching "<span class='search-query'></span>"</h1>
            
        </div>
    </div>
</div>

                        </div>
                    </div>
                
            </div>

            
                
                <a href="../intro/concepts.html" class="navigation navigation-prev navigation-unique" aria-label="Previous page: 1.2. 概念与原则">
                    <i class="fa fa-angle-left"></i>
                </a>
                
                
            
        
    </div>

    <script>
        var gitbook = gitbook || [];
        gitbook.push(function() {
            gitbook.page.hasChanged({"page":{"title":"2. API概览","level":"1.2","depth":1,"next":{"title":"3. observable 相关","level":"1.3","depth":1,"ref":"","articles":[{"title":"3.1. observable","level":"1.3.1","depth":2,"path":"refguide/observable.md","ref":"refguide/observable.md","articles":[]},{"title":"3.2. @observable","level":"1.3.2","depth":2,"path":"refguide/observable-decorator.md","ref":"refguide/observable-decorator.md","articles":[]},{"title":"3.3. objects","level":"1.3.3","depth":2,"path":"refguide/object.md","ref":"refguide/object.md","articles":[]},{"title":"3.4. arrays","level":"1.3.4","depth":2,"path":"refguide/array.md","ref":"refguide/array.md","articles":[]},{"title":"3.5. maps","level":"1.3.5","depth":2,"path":"refguide/map.md","ref":"refguide/map.md","articles":[]},{"title":"3.6. boxed values","level":"1.3.6","depth":2,"path":"refguide/boxed.md","ref":"refguide/boxed.md","articles":[]},{"title":"3.7 decorators","level":"1.3.7","depth":2,"path":"refguide/modifiers.md","ref":"refguide/modifiers.md","articles":[]}]},"previous":{"title":"1.2. 概念与原则","level":"1.1.2","depth":2,"path":"intro/concepts.md","ref":"intro/concepts.md","articles":[]},"dir":"ltr"},"config":{"plugins":["github","edit-link","anchors","copy-code-button","github-buttons"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"github":{"url":"https://github.com/SangKa/mobx-docs-cn"},"search":{},"lunr":{"maxIndexSize":1000000,"ignoreSpecialCharacters":false},"fontsettings":{"theme":"white","family":"sans","size":2},"highlight":{},"github-buttons":{"buttons":[{"user":"SangKa","repo":"MobX-Docs-CN","type":"star","size":"small","count":true},{"user":"SangKa","repo":"MobX-Docs-CN","type":"fork","size":"small","count":true}]},"copy-code-button":{},"sharing":{"facebook":true,"twitter":true,"google":false,"weibo":false,"instapaper":false,"vk":false,"all":["facebook","google","twitter","weibo","instapaper"]},"edit-link":{"label":"完善文档","base":"https://github.com/SangKa/mobx-docs-cn/tree/master/docs"},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false},"anchors":{}},"theme":"default","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{},"title":"MobX 中文文档","gitbook":"3.2.2"},"file":{"path":"refguide/api.md","mtime":"2018-09-18T13:06:39.945Z","type":"markdown"},"gitbook":{"version":"3.2.2","time":"2018-09-18T13:06:52.064Z"},"basePath":"..","book":{"language":""}});
        });
    </script>
</div>

        
    <script src="../gitbook/gitbook.js"></script>
    <script src="../gitbook/theme.js"></script>
    
        
        <script src="../gitbook/gitbook-plugin-github/plugin.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-edit-link/plugin.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-copy-code-button/toggle.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-github-buttons/plugin.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-search/search-engine.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-search/search.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-lunr/lunr.min.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-lunr/search-lunr.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-sharing/buttons.js"></script>
        
    
        
        <script src="../gitbook/gitbook-plugin-fontsettings/fontsettings.js"></script>
        
    

    </body>
</html>

